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Rails 5 开发 进 阶 


本 书 主要 包括 两 部 分 : Rails 源码 剖析 和 Rails 使 用 指南 。Rails 是 一 个 Web 开发 框 
架 ， 也 是 一 个 工具 。" 工 欲 善 其 事 必 先 利 其 器 "， 想 要 更 好 的 使 用 Rails 这 个 工具 ， 
清楚 其 背后 的 魔法 ， 阅 读 源 代码 是 必 备 功课 。 


本 书 尽量 做 到 系统 、 全 面 ， 从 源码 出 发 ， 会 讲解 到 原理 。 本 书 大 部 分 内 容 为 原创 ， 
少数 内 容 为 整理 网 上 资料 ， 鉴 于 参考 资料 太 多 ， 想 我 不 能 一 一 列举 来 源 。 


本 书 适合 什么 样 的 读者 ? 


e 想 要 更 好 的 使 用 Rails 

e 准备 阅读 Rails 的 源 代码 
e 想 知 道 Rails 的 整体 架构 
e 想 清楚 Rails 背后 的 魔法 


本 书包 含 了 哪些 内 容 ? 


e 一 些 文档 里 找 不 到 的 方法 
。 每 个 模块 的 关键 所 在 
。 源码 阅读 路 线 图 


本 书 不 讲 哪些 内 容 ? 


e 安装 、 部 署 

e GET 

e Ruby 747% ` Rails AT] 

e 和 具体 业务 相关 的 问题 或 功能 
e 非常 具体 、 底 层 的 代码 实现 


本 书目 的 


e 让 使 用 其 它 语言 、 框 架 的 技术 人 员 ， 能 看 懂 是 什么 
e 让 已 经 入 门 的 Rails 使 用 人 员 ， 知 道 更 多 原理 ， 能 看 懂 怎 么 用 


联系 我 


邮箱 : leekelby@gmail.com 


2017-6-16 更 新 说 明 


ActiveModel validate 的 使 用 ; Turbolinks 5 的 推荐 。 


Active Job 


Web 开发 过 程 中 ， 会 遇 到 很 多 需要 异步 处 理 的 任务 : 发 邮件 、 发 短信 、 图 片 处 理 、 
下 载 东 西 、spam 检测 等 。 一 般 来 说 ， 这 样 的 程序 执行 时 间 长 ， 并 且 不 需要 实时 把 

结果 反馈 给 用 户 。 我 们 可 以 将 这 些 处 理 时 间 长 的 请 求 剥离 出 来 异步 处 理 ， 并 及 时 响 
应 页 面 的 请 求 9 

市 面 上 已 经 有 不 少 和 这 有 关 的 gem， 它 们 封装 好 了 接口 ， 我 们 直接 调用 即 可 ， 比 如 
受到 广泛 使 用 的 Resque ` Sidekiq ` Delayed job 等 。 

这 些 gem 做 的 事情 都 大 同 小 异 ， 但 特性 上 却 各 自 不 同 : 


异步 ”队列 延 时 (定时 ) 优先 级 Al R 


Delayed Job 是 是 是 任务 全 局 ER 
Resque 是 是 是 (Gem) 队列 全 局 是 
Sidekiq 是 是 是 队列 € 任务 


并 且 ， 在 实际 使 用 过 程 中 ， 你 会 关心 性 能 怎么 样 、 是 否 支 持 多 线程 、 持 久 化 方案 ， 

以 及 API 使 用 难 易 程度 、 稳 定性 等 问题 。 也 就 是 说 ， 你 有 可 能 要 更 改 异 步 处 理 所 使 

用 的 gem. 

必要 的 话 ， 你 要 快速 切换 到 另 一 种 异步 处 理 方案 上 。 更 进一步 ， 你 不 想 被 绑 在 一 

树 上 ， 不 想 每 换 一 种 方案 都 学 习 其 专 有 的 语法 。 

Active Job 解决 了 这 个 问题 ， 它 统一 了 接口 ， 做 到 了 : 不 同 的 延迟 任务 ， 一 样 的 

API. pen Job AF HARE RLGGE 898 XR IE AER ZERO CMO EBM RT 
择 使 用 自己 需要 的 方案 ， 并 且 以 后 可 以 迁移 到 其 它 方案 。 


Queue Adapter 


定义 : 配置 使 用 哪 种 后 端 任务 、 队 列 管理 方式 。 默 认 使 用 的 queue_adapter 是 
:inline ， 处 理 方 式 是 立即 执行 任务 。 你 需要 自己 设置 queue_adapter. 


ActiveJob::Base.queue adapter = :inline 


Rails.application.config.active job.queue adapter - :test 


已 经 支持 Resque ^ Sidekiq ^ Delayed Job 等 常用 延迟 任务 gem， 所 有 可 用 
adapter: 


:backburner, :delayed job, :qu, :que, :queue classic, 
resque, :sidekiq, :sneakers, :sucker punch, 
:inline, :test 


Queue Name 


定义 : 任务 都 是 先进 队列 里 ， 队 列 都 有 名 字 的 ， 方 便 管理 。 默 认 使 用 的 
queue name X "default" 


可 以 定制 : 


class MyJob < ActiveJob::Base 
queue as :my jobs 


def perform(record) 


end 
end 


通过 config.active job.queue name prefix- 可 给 所 有 队列 名 加 前 级 。 


Queue Priority 


定义 : 队列 有 优先 级 这 个 属性 ， 优 先 级 高 的 会 被 先 执行 。 类 方法 
queue with priority 可 以 进行 设置 ， 对 整个 类 有 效 : 


class PublishToFeedJob < ActiveJob::Base 
queue with priority 50 


def perform(post) 
post.to feed! 
end 
end 


可 用 实例 方法 priority 获取 ， 由 上 面 统一 设置 的 。 


Core 
调用 : 设置 任务 所 在 队列 、 队 列 优先 级 行 。 类 方法 set 使 用 举例 : 


VideoJob.set(queue: :some queue).perform later(Video.last) 
VideoJob.set(wait: 5.minutes).perform later(Video.last) 
VideoJob.set(wait until: Time.now.tomorrow).perform later(Video. 
last) 


VideoJob.set(queue: :some queue, wait: 5.minutes) 
.perform later(Video.last) 


VideoJob.set(queue: :some queue, wait until: Time.now.tomorrow) 
.perform later(Video.last) 


VideoJob.set(queue: :some queue, wait: 5.minutes, priority: 10) 
.perform later(Video.last) 


set 支持 可 选 参 数 : :wait、:wait until ^ :queue ` :priority > CN R-4& È 3, 8 
ConfiguredJob 完成 ， 主 要 是 处 理 各 个 参数 ， 起 到 配置 作用 。 
Note : 可 以 不 使 用 set 直接 调用 perform later 进 队 列 ， 然 后 等 待 执 


行 。 


类 方法 : 


deserialize 


实例 方法 : 


serialize 
deserialize 


它们 只 是 后 端 任务 信息 的 一 种 方式 ， 在 此 不 必 深 究 。 


Enqueuing 入 人 队 与 重 试 
调用 。 
常用 方法 : 


enqueue 


使 用 举例 : 


my job instance.enqueue 


my job instance.enqueue wait: 5.minutes 

my job instance.enqueue queue: :important 
my job instance.enqueue wait until: Date.tomorrow.midnight 
my job instance.enqueue priority: 10 


gem AJ TLEN ? ZT wait^wait until 
入 队列 、 执 行 任务 失败 ， 捕 提 后 ， 还 可 以 重 试 : 
retry_ job 


使 用 举例 : 


class SiteScrapperJob « ActiveJob::Base 
rescue from(ErrorLoadingSite) do 
retry job queue: :low priority 
end 
def perform(*args) 
4 raise ErrorLoadingSite if cannot scrape 


end 
end 


除 上 述 两 实例 方法 外 ， 还 有 类 方法 : 


perform later 


Execution 执行 
调用 。 

# 实例 方法 

perform now 


execute # 由 子 类 ， 也 就 是 我 们 所 定义 的 Job 实现 具体 内 容 


HO UE 
perform now # 简单 封装 了 实例 方法 perform now 


execute 


使 用 举例 : 
MyJob.new(*args).perform now 


MyJob.perform_now( "mike") 


使 用 perform now 代码 会 立即 执行 ， 在 这 开发 环境 会 很 实用 。 


Callbacks 回调 


定义 + 自动 调用 。 


比 某 些 延 迟 gem 多 做 了 一 点 点 ， 除 了 队列 & 执 行 本 身 外 ， 还 可 以 有 回调 : 


before enqueue 
around_enqueue 
after_enqueue 


before perform 
around perform 
after perform 


使 用 举例 : 


class VideoProcessJob < ActiveJob::Base 
queue as :default 


after perform do |job| 
UserMailer.notify video processed(job.arguments.first) 
end 


def perform(video id) 
Video.find(video id).process 
end 
end 


其 它 几 个 方法 类 似 。 


Note: 实现 上 ， 使 用 了 ActiveSupport::Callbacks 的 define callbacks ^ 
set callback ` run callbacks 等 方法 。 
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建 任 务 、 进 队列 、 执 行 任务 这 几 个 步骤 ， 尽 管 我 们 可 以 区 分 开 ， 但 很 多 时 候 它 们 
是 交织 在 一 起 的 (从 API 上 就 能 看 出 )， nes 


& 


^ 


使 用 Active Job AFA # > TAME eR : 


R gem 本 身 的 特性 没 能 充分 发 挥 ， 灵 活性 降低 ， 和 其 它 gem 的 集成 会 变 复 杂 。 


其 它 多 个 类 或 模块 ， 统 一 在 此 列举 。 
命令 行 快捷 生成 
rails generate job NAME [options] 
异常 捕获 与 处 理 
使 用 Active Support 的 异常 捕获 方法 rescue_from 


class GuestsCleanupJob < ActiveJob::Base 
queue as :default 


rescue from(ActiveRecord::RecordNotFound) do [exception | 


end 


N 


参数 支持 Global ID 


—AZ XB. 7|(enqueue in ` enqueue at 和 enqueue) 只 传 能 够 标识 对 象 的 那 部 分 参 
数 (如 : class、id)， 出 队列 /执行 的 时 候 再 根据 这 些 参数 获取 对 象 。 


但 因为 serialize_argument 支持 的 类 型 有 多 种 ， 其 中 就 包括 
GloballD::Identification. 所 以 我 们 可 以 传递 一 个 " 活 的 对 象 " 进 队 列 ， 而 不 只 是 它 的 一 
部 分 (如 : class ^ id). 


使 用 Global ID 前 后 对 比 。 


之 前 : 


class TrashableCleanupJob 
def perform(trashable class, trashable id, depth) 
# 出 队列 /执行 的 时 候 需 要 根据 trashable class 和 trashable id 查询 
相应 trashable 
trashable = trashable class.constantize.find(trashable id) 
trashable.cleanup(depth) 
end 
end 


Zj? 


class TrashableCleanupJob 
def perform(trashable, depth) 
4 出 队列 /执行 的 时 候 直接 使 用 trashable 
trashable.cleanup(depth) 
end 
end 


Note: 以 前 直接 传递 对 象 是 不 规范 的 写法 。 
获取 任务 的 部 分 信息 
所 带 参数 、 任 务 id、 所 在 队列 名 、 优 先 级 等 : 


Qarguments = arguments 

Qjob id - SecureRandom.uuid 
Qqueue name = self.class.queue name 
Qpriority self .class. priority 


# Job arguments 
attr accessor :arguments 


# Timestamp when the job should be performed 
attr accessor :scheduled at 


4 Job Identifier 
attr accessor :job id 


# ID optionally provided by adapter 
attr accessor :provider job id 


4 I18n.locale to be used during the job. 
attr accessor :locale 


Async Job 


已 经 异步 了 ， 再 给 你 一 个 选择 : 是 否 要 并 发 ? 


Rails.application.config.active job.queue adapter = :async 


进 队 列 后 ， 任 务 运用 Ruby 自身 的 并 发 。 数 据 放 在 内 存 里 ， 运 行 速度 加 快 了 ; 没有 
持久 化 ， 重 局 会 丢失 数据 。 


一 般 来 说 ， 生 产 环境 你 不 能 使 用 ， 但 开发 与 测试 或 许可 以 体验 。 


Arguments 参数 处 理 
接受 的 参数 类 型 很 广泛 ， 需 要 先 处 理 一 下 。 
进 队 列 时 参数 需要 serialize ， 执 行 前 参数 需要 deserialize 


当然 ， 这 都 是 自动 完成 的 。 


Queue Adapters 


原来 ， 不 同 的 延迟 任务 gem 有 各 自 不 同 的 self.perform ` perform ` run ^ work > I 
在 : 
都 有 同名 的 self.enqueue 和 self.enqueue at 


Logging 


around enqueue ` around perform 和 before enqueue 有 日 志 记录 ; 
enqueue ` enqueue at ^ perform start ^ perform 等 过 程 也 有 日 志 记 录 。 


默认 和 Rails 应 用 使 用 同一 日 志 系 统 。 


Identifier 


每 个 任务 都 有 全 局 唯一 的 job_id 


Configured Job 


可 实例 化 自 定 义 的 Job 类 ， 然 后 调用 perform now X perform later. Core 里 的 set 
类 方法 会 用 到 它 ， 主 要 作用 是 处 理 各 个 参数 ， 起 到 配置 作用 。 


解析 queue adapter 及 其 API 


queue adapter 是 Delayed Job ` Resque ` Sidekiq 等 不 同 的 延迟 任务 抽象 而 来 。 


而 queue adapter 所 用 的 API(enqueue_at ` enqueue_in ` enqueue 等 )， 也 是 从 
原 延 迟 任务 所 提供 的 API 抽象 而 来 。 


产 端 及 混合 使 用 注意 事项 

它 是 对 Resque、Sidekiq 等 的 封装 ， 对 比 其 文 覆 ， 可 以 看 出 部 分 功能 牺牲 掉 ， 部 分 
特性 被 欧 掉 了 。 

当 你 想 要 这 部 分 功能 、 特 性 ， 而 又 同时 使 用 着 Active Job MEER: 


1) 这 些 底层 的 gem 传递 的 是 id， 而 Active Job AAA GloballD 支持 可 以 传 
record 对 象 。 


2) 部 分 功能 、 特 性 Active Job 是 没有 的 ， 定 义 、 调 用 的 时 候 需 要 特别 注意 ， 因 为 
有 的 地 方 即使 你 用 错 了 ， 它 也 不 会 报错 。 


Action Mailer 


Action Mailer 是 Rails 内 建 的 组 件 ， 用 来 处 理 邮 件 相 关 业 务 。 
它 依赖 于 Rails 内 建 的 其 它 组 件 ， 如 : Active Job ` Abstract Controller 和 Action 
View， 以 及 外 部 gem 'mail'. 


因为 是 Rails 内 建 的 组 件 ， 所 以 使 用 上 通常 集成 于 Rails 项 目 ， 但 其 实 它 也 可 以 在 
Rails 之 外 使 用 。 


核心 是 gem 'mail' 
既然 是 用 来 处 理 邮件 相关 业务 ， 那 么 核心 功能 当然 就 是 邮件 处 理 ， 这 部 分 由 gem 
'mail' 完成 。 


gem 'mail' 可 用 于 邮件 处 理 ， 包 括 创建 、 发 送 、 和 接收 等 ， 示 例如 下 : 


require 'mail' 


Mail.defaults do 
delivery method :smtp, 


:address -» "smtp.gmail.com", 

:port => 58V, 

: domain => "example.com", 
:authentication => :plain, 

:user name => "<gmail_username>@gmail.com", 
: password => "<gmail_password>", 


:enable starttls auto => true 
end 


mail = Mail.new do 
from 'fromQexample.com' 
to 'to@example.org' 
subject 'First multipart email sent with Mail' 


text_part do 
body 'This is plain text' 
end 


html_part do 
content_type 'text/html; charset=UTF-8' 
body '<h1>This is HTML</h1>' 
end 
end 


mail.deliver! 


上 面 的 例子 使 用 了 Gmail 做 为 邮件 服务 器 ， 所 以 需要 用 到 Gmail 用 户 名 和 密码 ， 实 
际 应 用 中 你 可 以 在 本 地 搭建 或 使 用 其 它 第 三 方 邮件 服务 器 。 更 多 示例 ， 可 以 参考 
mail#usage 


Note: 发 送 邮 件 ， 还 可 以 使 用 标准 库 Net:SMTP 


引入 其 它 ， 为 了 更 好 用 


直接 使 用 gem 'mail， 创 建 、 发 送 邮件 等 最 最 基本 的 功能 是 实现 了 ， 但 并 不 好 用 。 
缺少 灵活 的 配置 ， 内 容 与 模板 没有 分 离 等 。Action Mailer 改善 了 它们 ， 举 例 单独 使 
用 action mailer : 


# mailer.rb 
require 'action mailer' 


# 邮件 发 送 报 错时 ， 是 否 把 错误 信息 发 送 给 用 户 。 开 发 环境 下 ， 可 设置 为 true 
ActionMailer::Base.raise delivery errors = true 


# 使 用 单独 配置 文件 的 话 ， 可 以 用 config.action mailer 代替 下 面 的 ActionM 
ailer::Base 
ActionMailer::Base.delivery method - :smtp 
ActionMailer::Base.smtp settings - ( 

:address -» "smtp.gmail.com", 

:port => 587, 

:domain => "example.com", 

:authentication => :plain, 

:user_name => "test@example.com", 

: password => "password", 

:enable starttls auto => true 


ActionMailer::Base.view paths = File.dirname( FILE ) 


class Mailer « ActionMailer::Base 
def daily email 
Qvar = "var" 


# 发 件 人 是 这 里 的 from» LEG smtp settings 里 设置 的 
mail(to: "to@gmail.com", from: "testQexample.com", subject: 
"test") do |format | 
format.text 
format.html 
end 
end 
end 


email = Mailer.daily_email 
email.deliver_now 


mailer/daily email.html.erb 
<p>this is an html email</p> 
<p> and this is a variable <%= @var %></p> 


4 mailer/daily email.text.erb 
this is a text email 
and this is a variable <%= Qvar 96» 


配置 部 分 可 以 抽取 出 来 ， 模 板 和 内 容 可 以 分 开 管 理 ， 创 建 和 发 送 邮 件 也 更 加 直观 。 


引入 其 它 ， 为 了 更 实用 


， 除了 邮件 发 送 外 ， 我 们 还 需要 其 它 功 能 ， 这 就 有 一 个 "集成 "的 过 程 。 我 们 项 
Mud 、 能 够 自动 化 、 能 够 预览 邮件 等 。 我 们 想 用 Rails 其 它 组 件 提供 的 
render, before action, url for 以 及 丰富 的 helper 方法 。 


运行 下 面 命 令 即 可 自动 生成 邮件 模板 : 


rails generate mailer Notifier welcome 


实现 方式 : RARE, 功夫 在 诗 外 


Action Mailer 本 身 并 没有 "实现 "什么 功能 。 最 基本 ， 也 是 最 核心 的 部 分 由 gem 
‘mail’ 完成 ; 为 了 更 好 用 、 更 实用 ， 加 载 或 封装 了 Active Job ^ Action Pack 和 
Action View. 


为 了 做 好 、 做 得 上 层次 ， 下 面 是 在 邮件 处 理 外 ，Action Mailer "实现 "的 一 些 功能 


° pe “是 邮件 服务 ) 
e 拦截 器 、 观 察 者 (发 送 之 前 、 之 后 想 做 点 什么 ?) 
e 测试 

e 日 志 记 录 

e AUR Ai 

e 灵活 的 配置 

e 内 容 与 模板 分 离 

e 丰富 实用 的 helper 方法 


e 邮件 预览 
e 自动 化 (如 : rails g mailer) 


Base 


它 是 Action Mailer 里 其 它 模块 的 集合 中 心 (其 它 模块 不 直接 对 外 提供 接口 ， 而 是 通 
过 Base 完成 ) 。 

同时 ， 它 还 提供 一 些 对 外 的 接口 ， 供 我 们 直接 使 用 。 

此 外 ， 它 还 起 到 承上启下 的 作用 ， 虽 然 我 们 可 能 感受 不 到 。 例 如 : 与 底层 其 它 模块 
交互 ， 负 责 将 请 求 转向 具体 的 Mailer#action 等 。 


它 是 我 们 自 定义 Mailer 的 父 类 ， 是 连接 我 们 应 用 与 Action Mailer 的 纽带 ， 是 
Action Mailer 连接 Abstract Controller 的 纽带 。 
作用 


它 继 承 于 AbstractController::Base > 227 —3* B X & Abstract Controller 的 模块 
(尽管 有 的 模块 它 并 没有 使 用 到 )， 作 用 是 为 了 让 它 的 子 类 (我 们 自 定 义 的 Mailer X) 
能 够 "更 好 用 、 更 实用 "。 


YourMailer 


| 
V 


ActionMailer::Base 


| 
V 


AbstractController::Base 


包含 内 容 
包含 了 一 些 默 认 配 置 default params. 

注册 拦截 器 (interceptor) 或 观察 者 (observer). 

请 求 到 邮件 处 理 process. 

创建 邮件 实例 (AA Base include 了 多 个 模块 ， 所 以 这 个 实例 可 以 使 用 这 些 模块 所 


定义 的 方法 ) 。 


邮件 (mail)、 附 件 (attachments) 


mail(headers = (), &block) 表示 邮件 对 象 。 


参数 AL 
:subject 主题 

:from 发 件 人 

:to 收 件 人 

"CC dix 

:bcc 密 送 

:reply_to 回 邮 地 址 

:date 时 间 


Note: 想 了 解 更 多 header 信息 ， 可 以 点 击 Email#Header_fields 


使 用 举例 : 


def welcome(user) 
Quser - user 


mail(to: Quser.email, subject: 'Welcome to My Awesome Site!) 
end 


attachments() 人 允许 你 在 邮件 里 添加 附件 。 


类 型 : 


a mailer.attachments.class 
# => Mail::AttachmentsList 


# 类 似 数 组 


a mailer.attachments 
# => [] 


使 用 举例 : 


# 文件 名 的 方式 
mail.attachments['filename.jpg'] # => Mail::Part 实例 对 象 或 nil 


B X552 X 
mail.attachments[®] # => Mail::Part (第 一 个 实例 对 象 ) 


只 需要 指定 文件 名 、 文 件 类 型 ， 然 后 Rails 会 自动 帮 你 计算 出 Content-Type， 
Content-Disposition, Content-Transfer-Encoding 和 base64 编码 等 附件 内 容 。 


你 也 可 以 重 写 它 们 : 


mail.attachments['filename.jpg'] = ( mime type: 'application/x-g 
Zap 

content: File.read('/path/t 
o/filename.jpg') ) 


iX 3 SKU f& (default & default options-) 


default(value = nil) 是 ActionMailer::Base 提 供 的 方法 ， 用 来 设置 
default params， 默 认 已 经 有 : 


default params = ( 
mime version: "1.0", 
charset: "UTF-8", 
content type: "text/plain", 
parts order: | "text/plain", "text/enriched", "text/html" | 


我 们 可 以 配置 (value 必需 是 Hash 类 型 ) : 


# 下 面 两 者 一 样 

config.action mailer.default ( from: "no-replyQexample.org" } 
config.action mailer.default options - ( from: "no-replyQexample 
.Org" } 


# 常见 配置 (开发 模式 下 ) 
config.action mailer.default url options = ( :host => 'localhost 
:9000' } 


config.action mailer.delivery method - :smtp 


# 根据 不 同 发 送 方式 ， 做 不 同 配置 
config.action mailer.smtp settings = ( 
address: 'smtp.gmail.com', 
port: 587, 
domain: 'your domain.com', 
# 完整 的 邮箱 地 址 
user name: 'your emailQgmail.com', 
password: 'your gmail password', 
authentication: 'plain', 
enable starttls auto: true 


# 邮件 发 送 报 错时 (比如 : 邮箱 错 了 )， 是 否 抛 异常 。 开 发 环境 下 ， 可 设置 为 true 
config.action mailer.raise delivery errors = true 

# 是 否 监 的 发 邮件 ， 默 认 已 经 是 true 

config.action mailer.perform deliveries = true 

# 遇 到 以 下 报错 ， 可 考虑 : 

# Net::SMTPAuthenticationError: 535 #5.7.0 Authentication failed 


:openssl verify mode -» 'none' 


它 和 配置 文件 里 的 default options- 是 一 样 。 


在 config/environments/ 目录 下 针对 不 同 执行 环境 会 有 不 同 的 邮件 服务 器 设置 : 


config.action mailer.default options - ( from: "no-replyQexample 
.org" } 


前 者 对 当前 Controller 及 其 子 类 有 效 ， 而 后 者 对 当前 环境 下 所 有 Controller Zi zx » 
除了 使 用 的 地 方 不 同 ， 导 致 作用 域 稍 有 不 同 外 ， 两 者 本 质 是 一 样 的 。 


4 E 


设置 头 部 消息 headers 


使 用 headers 可 以 设置 邮件 的 头 部 消息 ， 例 妈 


headers['X-Special-Domain-Specific-Header'] = "SecretValue" 


headers 'X-Special-Domain-Specific-Header' -» "SecretValue", 
'In-Reply-To' => incoming.message id 


直接 调用 了 Mail::Message#headers 方法 ， 默 认 已 经 有 选项 


:subject 
:sender 

: from 

:to 

"CE 

: bcc 
:reply-to 
:orig-date 
:message-id 
references 


接收 邮件 receive 


Rails 处 理 邮件 ， 不 常用 ， 而 且 会 比较 耗费 资源 ， 所 以 不 推荐 。 但 如 果 你 要 用 的 
话 ， 你 可 以 实现 receive(raw mail) 方 ， 唯 一 的 参数 就 是 ， 接 收 到 的 邮件 内 
Rails 会 先 创 建 对 应 的 Mail 邮件 对 象 ， 之 后 才 进 行 后 续 处 理 。 


创建 邮件 对 象 时 的 魔法 


细心 的 你 应 该 发 现 ， 我 们 在 Mailer 类 里 定义 的 是 实例 方法 ， 但 创建 mailer 对 象 用 
的 却 是 类 方法 。 


这 里 隐藏 着 魔法 ， 当 找 不 到 此 类 方法 时 ， 就 会 调用 Rails 重新 实现 的 
method missing 类 方法 , 会 先 检查 action methods 里 是 否 有 同名 方法 ， 如 果 
有 ， 则 (把 此 方法 当做 参数 ) 创 建 MessageDelivery 对 象 。 


register interceptor # 简单 封装 Mail.register interceptor 
register interceptors Z 简单 封装 上 面 的 register interceptor, TE# 


多 个 拦截 器 。 


register observer # 简单 封装 Mail.register observer 
register observers 4 简单 封装 上 面 的 register observer, VizM#S* 
观察 者 。 

方法 : 


mailer name & controller path 


返回 Mailer 类 的 名 字 ， 上 默认 与 类 名 同名 。 


拦截 器 register interceptor 
邮件 真正 地 发 送 之 前 想 做 点 什么 ?2-- 使 用 拦截 器 。 


为 了 "开发 和 测试 尽量 的 接近 生产 环境 "和 "知道 发 送出 去 的 邮件 站 正 的 样子 "等 
的 ， 我 们 希望 在 非 生 产 环境 下 ， 能 够 查看 邮件 发 送 情况 。 


解决 方案 : 
e (开发 、 测 试 ) 用 邮件 预览 gem 

我 们 可 以 使 用 mailcatcher 或 letter opener 等 gem 实现 。 
e (生产 ) 只 发 送 到 特定 的 邮箱 

比如 ， 我 们 注册 一 些 特殊 账号 或 邮箱 ， 然 后 发 送 给 我 们 自己 。 
e 用 拦截 器 

也 就 是 下 面 要 介绍 的 。 

注册 拦截 器 。 举 例 一 (可 指定 条 件 ) : 


if Rails.env.development? 


ActionMailer::Base.register interceptor(DevelopmentMailInterce 
ptor) 
end 


注册 拦截 器 。 举 例 二 (没有 加 载 的 话 ， 需 要 先 加 载 ) : 


require 'whitelist interceptor' 
ActionMailer::Base.register interceptor(WhitelistInterceptor) 


注册 拦截 器 。 举 例 三 (没有 加 载 的 话 ， 需 要 先 加 载 ) : 


require 'environment interceptor!' 
ActionMailer::Base.register interceptor(EnvironmentInterceptor) 


拦截 器 register interceptor 


上 述 代 码 ， 一 般 放 在 config/application.rb 或 config/environments/file name.rb 
或 config/initializers/file name.rb 文件 里 。 


实现 delivering email .举例 一 〈 在 最 后 时 刻 替换 掉 要 发 送 到 的 邮箱 ) 


class DevelopmentMailInterceptor 
def self.delivering email message 


message.subject = "[#{message.to}] #{message.subject}" 
message.to = "overwrite_to@example.com" 
end 
end 


实现 delivering email . 举例 二 ( 白 名 单 ， 群 发 公司 邮箱 ) 


class WhitelistInterceptor 
def self.delivering email message 


unless message.to.join(' ') =~ /(@yourcompany.com)/i 
message.subject = "#{message.to} #{message.subject}" 
message.to = ENV['NOTIFICATIONS EMAIL' ] 
end 
end 


end 


实现 delivering email .举例 三 〈 非 生产 环境 时 ， 标 明 发 邮件 所 在 的 运行 环 


境 ) 


class EnvironmentInterceptor 
def self.delivering email message 
unless Rails.env.production? 
message.subject = "[#{Rails.env.capitalize}] #{message.sub 
ject}" 
end 
end 
end 


上 述 代 码 ， 一 般 放 在 lib/file_name.rb 文件 里 。 


上 面 大 概 思 路 已 经 给 出 ， 实 际 项 目 如 何 使 用 可 以 自行 决定 。 


拦截 器 register interceptor 
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订阅 者 register observer 


邮件 发 送 之 后 想 做 点 什么 ?-- 使 用 观察 者 。 


类 似 register interceptor， 使 用 观察 者 : 
class MailObserver 


# 实现 delivering email 方法 
def self.delivered email message 


ActionMailer::Base.register observer(MailObserver) 


注意 : 这 里 实现 的 是 delivered email 方法， 而 之 前 实现 的 是 


delivering email 方法 。 


Mail Helper 


几 个 邮件 相关 的 Helper 方法 。 


如 : attachments ` mailer ` message ° A7 A% M 49 block format ^ 
format_paragraph. 


方法 解释 
message() 表示 邮件 对 象 ， 即 Mail::Message 实例 对 象 
attachments() 表示 邮件 里 面 的 附件 
format paragraph(text, len = 格式 化 文字 内 容 。 默 认 行 首 空 两 格 ， 每 行 长 
72, indent = 2) 度 不 超过 72 个 字符 
x Sp. N JU 2 
Ss BITES, as format paragraph #222 X Ft 
文字 内 容 

YourMailer 的 实例 对 象 ， 类 似 YourController 

mailer() i3 bug 


a > Mailer 7€ 2&3 A fe Controller 泻 梁 视图 ， 它 们 原理 和 过 程 基本 上 是 一 致 的 。 所 
以 除了 上 述 Helper 方法 外 ，Action View 提供 的 辅助 方法 在 这 里 也 可 用 。 


Message Delivery 


应 用 层面 的 邮件 发 送 。 


发 送 邮 件 时 ， 会 调用 YourMailer#action， 在 这 里 就 会 创建 Message Delivery 实例 
xpo 


实例 方法 : 


deliver now 
deliver now! 


deliver later 
deliver later! 


和 


message 


deliver now 和 deliver now! 立即 发 送 邮 件 。 
deliver later 和 deliver later! 延迟 发 送 邮件 ， 可 接受 参数 
‘wait ^ :wait until 或 :queue. 


通常 ， 我 们 都 是 创建 邮件 并 发 送 : 


Notifier.welcome("helloworldQexample.com").deliver now 


也 可 以 先 创建 邮件 对 象 ， 稍 后 邮件 对 象 调 用 方法 发 送 邮 件 : 


message = Notifier.welcome("helloworldQexample.com") 


# => 得 到 ActionMailer::MessageDeliver 实例 对 象 


message.deliver now 


; UID YS Bee TET 
H th 77 & 23 H 
H PATA H 


T A 3 wp 


无 论 哪 种 方式 发 送 邮 件 ， 都 要 先 得 到 message *i € * MM deliver 方法 ， 然 后 调用 
gem 'mail' 相关 代码 实现 发 送 。 


获取 Mail::Message 实例 对 象 (deliver 操作 其 实 是 由 它 发 出 ) : 


# 表示 邮件 对 象 ， 它 本 质 是 Mail::Message 的 实例 对 象 
message = Notifier.welcome(david).message 


其 它 使 用 示例 : 


Notifier.welcome(User.first).deliver later 
Notifier.welcome(User.first).deliver later(wait: 1.hour) 
Notifier.welcome(User.first).deliver later(wait until: 10.hours. 
from now) 


Note: 这 里 的 邮件 "发 送 "， 指 的 是 我 们 应 用 层面 的 "发 送 "。 至 于 Rails 底层 如 何 
实现 邮件 "发 送 "， 参 考 【Delivery Methods】 章 节 。 


HE 


更 多 关于 Action Mailer 


Action Mailer 使 用 模板 来 创建 邮件 与 Action Controller 使 用 模板 泻 当 视图， 原理 类 
似 。 并 且 ， 泻 染 过 程 都 会 运用 到 Action View 的 Rendering 模块 。 

Action Mailer 提供 我 们 Mailer 类 和 视图 。Mailer 类 放 在 app/mailers 目录 下 ， 关 联 
的 视图 文件 在 app/views 目录 下 。 


ActionMailer::Base 继承 于 类 AbstractController::Base, 又 包含 但 不 限于 以 下 ' 外 
部 ' 模 块 ， 根 据 Ruby 规则 ， 它 们 也 是 可 调用 的 。 包 括 : 


模块 作用 
ActionMailer::DeliveryMethods 邮件 发 送 
ActionMailer::Previews 邮件 预览 
AbstractController::Rendering ia 


AbstractController::Helpers 引进 、 输 出 辅助 方法 AbstractController::Translation | 
I18n 相关 AbstractController::Callbacks | 支持 回调 ActionView::Layouts | 视图 布局 


AE 


等 
C<B<A 


有 时 候 B 要 extend 和 人， 并 不 是 为 了 B 自己 使 用 ， 而 是 为 了 方便 C. 
ActionMailer::Base 部 分 代码 充当 的 角色 和 BB 一 样 ， 它 自己 却 没 有 使 用 ， 而 是 为 了 
方便 我 们 自 定 义 的 Mailer 类 调用 。 


Au: 

Mailer 里 : 
before action :add inline attachment! 
layout "mailer" 


helper :application 


View € : 


<%= url for(host: "example.com", controller: "welcome", action: 
"greeting") %> 


<%= users url(host: "example.com") 96» 


另 ， 邮 件 是 要 发 送出 去 给 别人 看 的 ， 所 以 邮件 里 的 url 不 支持 使 用 相对 路 径 。 


快速 生成 Mailer 和 模板 


通过 以 下 命令 创建 mailer 类 和 视图 : 
$ rails g mailer UserMailer welcome 


create app/mailers/user_mailer.rb 

invoke erb 

create app/views/user mailer 

create app/views/user mailer/welcome.text.erb 
invoke test unit 

create test/mailers/user mailer test.rb 


Inline- Preview ln | 


Rails 自 带 的 拦截 器 ， 可 以 将 邮件 里 的 图 片 src 转换 data， 以 方便 显示 。 
原因 有 多 个 ， 其 中 之 一 : 有 的 邮件 客户 端 会 过 滤 图 片 的 ， 通 过 转换 可 以 提高 图 片 的 
显示 概率 。 


默认 已 经 使 用 此 拦截 器 ， 不 想 使 用 的 话 ， 需 要 手动 删除 : 


ActionMailer::Base.preview interceptors.delete(ActionMailer::Inl 
inePreviewInterceptor) 


Collector 


mail 方法 可 以 接收 一 个 代码 块 ， 你 可 以 在 这 里 指定 浑 染 模 板 的 格式 及 内 容 等 : 


mail(to: user.email) do |format| 
format.text 
format.html 

end 


# 或 


mail(to: user.email) do |format| 

format.text { render plain: "Hello World!" } 

format.html { render html: "<h1>Hello World!«/hi1»".html safe } 
end 


代码 块 里 的 format PPA Collector 的 实例 对 象 。 


也 只 有 在 这 个 时 候 ， 这 里 的 Collector 才 有 用 到 。 它 和 AbstractController::Collector 
Mime 相关 。 


Note: 默认 会 发 送 和 mail 所 在 方法 名 同名 的 所 有 模板 ， 不 区 分 Mime 格式 。 这 
也 是 我 们 常用 的 。 


Delivery-Job 


使 用 Active Job > EG E VA XE 3R ATK dp E o 


Delivery Methods 定制 与 新 增 
底层 选择 邮件 "发 送 "方式 。 
Rails 本 身 没 有 实现 此 功能 ， 但 提供 了 几 种 方式 供 我 们 选择 。 
调用 Rails 已 有 发 送 程序 
delivery method 默认 已 经 有 : 
:Smtp -» Mail::SMTP 
: file => Mail::FileDelivery 


:sendmail => Mail: :Sendmail 
: test => Mail::TestMailer 


我 们 可 以 根据 需求 ， 选 择 、 配 置 、 使 用 它们 。 


使 用 已 有 邮件 服务 


e 如 使 用 gem 'letter opener' 直接 配置 : 


nnn f n /anvirnnmontec /dava nnman t - 
config/environments/development.rb 


config.action mailer.delivery method - :letter opener 


e 如 使 用 gem 'aws-ses' 配置 : 


ActionMailer::Base.add delivery method :ses, AWS::SES::Base, 
:access key id -» 'abc', 
'secret access key => '123' 


然后 : 


config.action mailer.delivery method = :ses 


"新 增 "邮件 服务 


完全 的 "新 增 " 邮 件 服 务 ， 难 度 上 比较 大 。 比 较 实 际 的 做 法 是 "继承 "于 已 有 的 实现 ， 
并 且 在 Rails 里 注册 一 下 ， 然 后 使 用 。 


1) "继承 "于 已 有 的 实现 (这 里 是 SMTP): 
require 'mail' 


class CustomSmtpDelivery « ::Mail::SMTP 
# SMTP 配置 
def initialize(values) 
self.settings = {:address => "smtp.gmail.com", 
:port => 587, 
:domain => 'yourdomain', 
:user_name => "gmail username", 
:password => "gmail password", 
:authentication -» 'plain', 
:enable starttls auto => true, 
:openssl verify mode -» nil 
}.merge! (values) 
end 


# 或 者 ， 把 SMTP 配置 放 到 配置 文件 里 

def initialize(options = {}) 
self.settings = options 

end 


attr_accessor :settings 


# 必须 重新 实现 deliver! 方法 

def deliver!(mail) 
# 把 收 箱 人 替换 成 指定 的 ， 这 里 功能 类 似 拦截 器 
mail['to'] = "toQexample.com" 
mail['bcc'] - [] 
mail['cc'] = [] 
super (mail) 

end 

end 


2) & Rails 里 注册 一 下 : 


add delivery method :custom smtp delivery, CustomSmtpDelivery 


另 ， 自 带 的 smtp file ^ sendmail 及 test 已 经 注册 。 


3) 配置 使 用 刚才 新 增 的 delivery method : 


# config/environments/development.rb 
config.action mailer.delivery method = :custom smtp delivery 


在 之 后 配置 就 变 成 了 : 


ActionMailer::Base.custom smtp delivery settings = ( 
:address => "smtp.gmail.com", 
:port => 587, 
Ho... 


Rails 已 有 发 送 程序 及 gem "letter opener' 都 是 用 这 种 方式 实现 ， 之 后 提供 给 我 们 
使 用 的 。 


提供 类 方法 : 


# 获取 所 有 可 用 的 delivery methods 
class attribute :delivery methods 


module ClassMethods 

4 必须 结合 delivery method :test 使 用 ， 存 放 着 已 经 deliver 的 邮件 对 象 
> 测试 的 时 候 可 用 到 它 。 

delegate :deliveries, :deliveries-, to: Mail::TestMailer 
end 


Previews & Preview 


邮件 预览 相关 。 
Previews， 主 要 是 对 外 的 接口 ， 对 于 普通 开发 者 来 说 主要 是 配置 
# 配置 预览 文件 存放 的 位 置 ， 默 认 如 下 : 


config.action mailer.preview path = '"Z(Rails.root)/lib/mailer pr 
eviews" 


H 配置 是 否 允 许 邮 件 预 览 。 开 发 模式 下 ， 默 认为 true 
config.action mailer.show previews = true 


默认 可 以 到 以 下 url, 查看 预览 邮件 : 


http://localhost:3000/rails/mailers/ 


提供 类 方法 : 


register preview interceptor 
register preview interceptors 


Preview， 主 要 是 对 内 的 实现 ， 是 我 们 自 定 义 YourPreview 的 父 类 ， 提 供 一 些 普通 
Web 开发 者 察觉 不 到 的 方法 ， 如 : 


preview name 返回 自 定 义 类 名 ， 但 把 "Preview" & AK ° 4 YourPreview 返 
w "Your" 


emails 返回 所 有 可 预览 的 邮件 


这 里 的 预览 ， 和 Mail Catcher ` Letter Opener 等 提供 的 预览 不 同 ， 它 属于 规范 的 测 
试 ， 而 后 者 更 类 似 于 人 肉 测试 。 


Note: 邮件 预览 ， 在 Rails 里 也 遵守 MVC. M 是 ActionMailer::Preview，V 是 
rails/mailers/ * C 是 Rails::MailersController 


a Kit» 
提供 类 方法 


all 
emails 


preview name 


call 
email exists? 


find 
exists? 


相关 使 用 ， 可 以 参考 官方 文档 。 


DeliveryJob 


Action Mailer 默认 就 已 经 支持 异步 发 送 ， 因 为 它 使 用 了 Rails B # #9 ActiveJob. 


具体 实现 体现 在 这 个 class 上 ， 它 完成 了 使 用 queue as 指定 队列 名 ， 使 用 
rescue from R > A perform 等 工作 (尽管 perform 还 是 调用 具体 Mailer 
里 的 代码 ) 。 


Collector 
支持 响应 不 同 格式 的 邮件 模板 ， 就 和 Controller#action 里 我 们 编写 的 类 似 : 


mail(to: 'mikelQtest.lindsaar.net') do |format| 
format.text 
format.html 

end 


Abstract Controller 


Abstract Controller 做 的 事情 很 有 限 ， 但 却 很 无 私 。 


无 论 是 它 自己 定义 的 方法 ， 还 是 封装 Action View 和 Action Dispatch 得 到 的 方法 ， 
最 终 都 提供 给 Action Controller 和 Action Mailer 使 用 。 


这 些 方法 (或 模块 ) 包 含 但 不 限于 泻 染 (模板 或 局 部 模板 )\、 Helpers ` Callbacks ` 
Mime、Url For 等 。 


它 服 务 于 Action Controller 和 Action Mailer. 


e 4434 ActionController::Base 将 战场 转移 到 具体 的 Controller#action( 经 过 
Metal). 


e 辅助 ActionMailer::Base 将 战场 转移 到 具体 的 Mailer#action. 


准备 及 转移 工作 在 之 前 已 经 完成 了 ， 它 只 是 在 最 后 一 步 ， 调 用 具体 action. 


Base 


Action Dispatch 里 转发 先 到 ActionController::Metal::action, 然后 到 
ActionController::Metal#dispatch, 接着 到 AbstractController::Base#process 也 就 是 
这 里 的 process 方法 ， 然 后 到 process action 和 send action & send ， 
最 后 到 具体 的 action 进行 处 理 。 


此 外 ， 还 有 一 些 平时 用 得 不 多 ， 但 比较 有 趣 的 方法 。 


重要 的 实例 方法 有 : 


process 


重要 的 私有 方法 有 : 
process_action 


send action & send 


重要 的 类 方法 有 : 
abstract! 


action methods 


action methods 返回 当前 类 所 包含 的 action， 上 默认 等 同 于 
public instance methods. 这 里 的 类 可 以 是 Controller > 47 Ax Mailer. 对 于 
Abstract Controller 来 说 ， 它 们 都 是 AbstractController::Base 的 子 类 ， 概 念 一 样 。 


其 它 实例 方法 : 


controller path 
action methods 


available action? 
其 它 类 方法 : 

clear action methods! 

controller path 

hidden actions 

internal methods 


method added(name) 


supports path? 


controller path 返回 当前 Controller 所 在 的 路 径 ( 包 括 目 录 、 文 件 名 )。 例 如 ， 
YourApp::PostsController 返回 "your_app/posts". 


其 它 私 有 方法 : 
action method? 


method for action 


Action Mailer 和 Action Controller 都 继承 于 Abstract Controller : 


ActionMailer::Base < AbstractController: :Base 


ActionController::Base < ActionController::Metal « AbstractContr 
oller::Base 


Base 
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获取 所 有 的 Controller 和 action 
如 何 获 取 当 前 程序 所 有 的 Controller 和 action ? 


获取 所 有 的 Controller: 


ApplicationController.descendants 


开发 环境 默认 是 延迟 加 载 的 ， 所 以 获取 的 只 是 当前 Controller ;为 了 达到 目的 ， 可 
以 先 运行 以 下 命令 : 


Rails.application.eager load! 


生产 环境 ， 不 必 运 行 。 


已 经 获取 了 所 有 的 Controller， 那 么 获取 某 个 Controller 所 有 的 action > M 
action methods 方法 即 可 : 


PostsController.action methods 


Helpers 
导出 、 引 入 辅助 方法 。 


方法 解释 


helper 把 Helper 方法 变 成 Controller 方法 ， 针 对 的 是 整个 module 
helper method 42 Controller 方法 变 成 Helper 方法 ， 针 对 的 是 单个 method 


helper(*args, &block) 


功能 和 include 类似 ， 只 是 稍微 智能 了 一 点 。 


参数 类 型 ， 可 分 为 3 类 : String、Symbol，Module，block。 这 些 参数 还 可 以 混合 


使 用 。 


e 当 参 数 是 模块 名 时 ， 直 接 include 此 模块 (没有 requires ) 


helper FooHelper # => includes FooHelper 


e 而 当 参 数 是 字符 串 或 符号 时 ， 会 根据 约定 require 相关 文件 ， 并 include 相关 模 


块 。 


helper :foo 
# => requires 'foo helper' 和 includes FooHelper 


helper 'resources/foo' 


# => requires 'resources/foo helper' 和 includes Resources::FooH 


elper 


此 外 ，helper 可 以 接受 并 处 理 一 个 代码 块 。( 不 推荐 ) 


最 后 要 说 的 是 : 上 述 参 数 类 型 可 以 混合 使 用 ， 你 可 以 同时 传递 符号 、 
和 代码 块 给 helper 方法 。 


helper(:three, BlindHelper) ( def mice() 'mice' end } 


FARB HOA 


helper method(*meths) 
以 元 编程 的 形式 定义 同名 Helper 方法 ， 然 后 send 调用 原 Controller 里 的 方法 。 


如 下 文 举例 ，Controller 里 有 _ current user 方法 ， 可 以 在 视图 里 使 用 : 


class ApplicationController < ActionController::Base 
helper method :current user, :logged in? 


def current user 

Qcurrent user ||= User.find by(id: session[:user]) 
end 
def logged in? 

current user !- nil 


end 
end 


在 视图 里 : 


<% if logged in? %>Welcome, <%= current user.name %><% end 96» 


helper 和 helper. method 可 以 简单 理解 为 一 对 作用 相反 的 操作 。 


除 上 述 两 方法 外 ， 还 有 : 
modules_for_helpers 


modules_for_helpers 被 上 面 的 helper 方法 所 调用 。 


clear_helpers 


clear_helpers 只 保留 与 此 Controller 同名 的 Helper 模块 的 辅助 方法 ， 其 它 模 
块 的 辅助 方法 清除 掉 。 


Callbacks 
Controller 里 可 用 的 回调 : 


before action & append before action 
prepend before action 
skip before action 


after action & append after action 
prepend after action 

skip after action 

around action & append around action 
prepend around action 


skip around action 


skip action callback & skip filter # 


这 些 回 调 方法 参照 物 都 是 process_action 方法 。 


set callback(:process action, callback, name, options) 


set callback(:process action, callback, name, options.merge(:pre 
pend -» true)) 


skip callback(:process action, callback, name, options) 
具体 实现 : 调用 了 ActiveSupport::Callbacks 里 的 


define callbacks ^ set callback ^ run callback 和 
skip callbacks 方法 。 


53 : skip action callback 意味 着 skip before ` after 和 around. 


Rendering 


Controller 和 Mailer " 浑 染 " 的 入 口 ， 并 负责 转 递 实例 变量 。 


泻 染 ，Abstact Controller 做 的 只 是 最 外 层 的 封装 。 具 体 由 Action View 的 
Rendering 相关 模块 完成 ， 然 后 给 Action Controller 和 Active Mailer 使 用 。 


Action Controller & Active Mailer 


| 
V 


Abstact Controller 


| 
V 


Action View 


EHRT Action View 里 的 Template Renderer 和 Partial Renderer > 444 render 
给 Action Controller, Action Mailer 演 染 模板 文件 或 局 部 模板 。 


大 大 


我 们 在 Controller#actions 里 使 用 的 render 就 是 在 这 里 定义 的 (尽管 它 只 是 简 
单调 用 ， 几 乎 没 做 任何 事 ) 。 


所 以 ， 在 使 用 render 过 程 中 有 疑问 的 话 ， 可 以 查看 View 里 对 应 render 方法 的 
文档 。 


除 上 述 方 法 外 ， 还 有 : 
view assigns 


view assigns 通过 它 可 以 查看 Controller 和 Mailer 传递 给 View 的 实例 变量 及 
其 内 容 。 在 ActionView::Rendering 里 被 调用 。( 通 过 Ruby 自 带 的 
instance variables ` instance variable get 得 到 ) 


render to body 
render to string 


rendered format 


这 些 方法 主要 起 到 接口 的 作用 ， 具 体 实现 在 上 游 或 下 游 。 


- £- Xr 3 LEG 
render 参数 汇总 与 详解 


render 参数 汇总 与 详解 
参数 主要 有 3 类 : 泻 染 格式 、 指 定 内 容 、 传 递 变 量 。 
ActionController:: Rendering 


H 泻 染 普通 文本 ， 不 带 格式 
: plain 
# 举例 render plain: "OK" 


4 BR html 格式 的 内 容 。 不 推荐 使 用 ， 可 用 html.erb KF 
:html 
# 举例 render html: "<strong>Not Found</strong>".html_safe 


8 泻 染 首 通 文本 ， 不 带 格式 。 不 推荐 使 用 ， 可 用 :plain 代替 
: text 


# 兼容 废除 的 :text， 默 认 是 普通 文本 。 不 推荐 使 用 
:body 


# 不 泻 沫 任何 东西 ， 已 废除 。 不 推荐 使 用 ， 可 用 :plain 代替 
:nothing 


Note: 不 想 泻 染 任 何 东 西 ， 还 可 以 使 用 方法 head A render to string 


# 指定 Header status 

: status 

# 指定 Header content type 
:content type 

4 指定 Header location 





: location 


& 必需 与 block 结合 使 用 ， 里 面 可 以 放 Prototype 等 代码 。 不 推荐 使 用 
:Update 


AbstractController:: Rendering 


# 指定 优先 泻 染 的 变种 


: variant 


alte » Ye 4€ show action > 12 


show. html+phone.erb 


ActionView::Rendering 


# 指定 优先 演 染 的 变种 
:variant 
# 指定 泻 染 的 格式 


:formats 


r 
N 


# IRRE RAJI 


: template 
Kis RH] action? 


las Paes 
oA E 


# 指定 
:action 

# 指定 要 泻 染 的 局 部 模板 
: partial 

4 指定 要 泻 染 的 文件 
:file 


# 泻 染 路 径 前 面部 分 
:prefixes 


# 举例 render :show, 
th render "posts/show" 


ActionView::Renderer 


E 
1 又 


# dE Bia ARE SR 


: partial 


request.variant 


重新 确认 对 应 


prefixes: 


= :phone 


应 的 模板 


'posts' 


则 优先 泻 染 : 


这 里 的 render 方法 ， 是 AV and AC 的 主要 入 口 ， 如 果 有 partial MÈ RÆ 
局 部 模板 ; 否则 ， 演 染 的 是 普通 模板 。 


ActionView::PartialRenderer 


AbstractRenderer 的 子 类 之 一 。 


# 配合 :COllection， 演 染 局 部 模板 时 ， 各 个 局 部 模板 之 间 穿 插 的 内 容 


:spacer template 


# 布局 
: layout 


# 传递 变量 


: locals 


# 指定 泻 染 格式 


:formats 


# 指定 要 泻 染 的 局 部 模板 


: partial 
浑 染 " 局 部 模板 "时 ， 约 定 : 每 一 个 局 部 模板 都 有 一 个 与 之 同名 的 "局 部 变量 "。 
例如 : 


render :partial => "person" 


则 在 局 部 模板 内 有 person 可 用 ， 它 代表 什么 内 容 ， 以 及 如 何 更 改名 字 。 和 以 下 
几 个 参数 有 关 : 


= 


# 传递 单个 对 象 时 ， 与 局 部 模板 同名 的 变量 


递 的 对 象 别 名 ， 更 改 默认 的 局 部 变量 名 字 


+E PES 
at 
HB 





# 传递 的 集合 ， 每 一 项 可 用 局 部 变量 代替 


:collection 


Note: 前 面 提 到 的 参数 :1ocals 也 可 传递 变量 ， 它 们 本 质 是 一 样 的 。 


ActionView::TemplateRenderer 


AbstractRenderer 的 子 类 之 一 。 


# 5% html 格式 的 内 容 
shtml 


# 泻 染 文件 ， 一 般 是 可 下 载 的 文件 (不 使 用 layout) 
# 你 可 以 手动 指定 ， 例 如 layout: true 
:file 


# 直接 演 染 代码 (不 使 用 layout) > RUM ERB 格式 。 不 推荐 使 用 

:inline 

# 举例 render inline: "<% products.each do |p| %><p><%= p.name %> 
</p><% end %>" 

# 必须 配合 :ijnline， 指 定 要 演 染 代码 的 类 型 

:type 

# 举例 type: :builder 


# 指定 模板 
:template 


# 指定 布局 
:layout 


# 传递 变量 
: locals 


# 兼容 :text， 默 认 是 普通 文本 。 不 推荐 使 用 


:body 
H 浑 染 普通 文本 。 不 推荐 使 用 
: text 
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ActionView::Helpers::RenderingHelper 


View € render 方法 所 在 地 ， 对 外 提供 接口 ， 处 于 最 外 层 。 
:partial 
: layout 
: locals 


作用 : 根据 参数 是 不 是 Hash 类 型 ， 参 数 有 没有 带 block? ACT ded ig H o 
如 果 不 传递 hash， 则 默认 演 染 partial 并 且 第 2 个 及 之 后 的 参数 做 为 locals hash. 


ActionController::Renderers (Metal 增强 模块 ) 
:json 
:callback 


:js 


:xml 
举例 render xml: @product 


ActionController::Renderer 


直接 泻 染 模板 ， 不 依赖 于 具体 Controllerztaction 时 ， 可 额外 传递 的 参数 : 


render 参数 汇总 与 详解 
# 指定 请 求 是 否 HTTPS 
:https 


# 指定 请 求 方法 
:method 
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Duy 


更 多 关于 ? 


> Zu 


render 在 Controller 7» View 59 IX 7| ? 
Controller 里 默认 浑 染 的 是 完整 的 模板 (template) 


走 的 路 是 ActionController::Rendering -> AbstractController::Rendering -> 
ActionView::Rendering -> ActionView::Renderer#render 


View XXX S RN X E ST (partial) 
走 的 路 是 ActionView::Helpers::RenderingHelper#render -> ActionView::Renderer 


通过 上 面 的 路 径 和 特别 指出 的 两 个 render 方法 里 面 的 逻辑 ， 不 难看 出 为 什么 可 以 
RUS Z template 或 partial. 


Controller 里 的 render 是 为 了 返回 self.response body 而 View 里 的 render 则 好 
像 为 了 浑 染 而 泻 染 ， 返 回 的 不 再 是 单纯 的 self.response_body 


循环 泻 染 单个 对 象 ， 还 是 泻 染 集合 ? 
优先 泻 染 一 个 集合 (参数 collection )， 而 不 是 一 个 局 部 模板 或 对 象 。 
<% Qadvertisements.each do |ad| %> 


<%= render partial: "ad", locals: ( ad: ad } %> 
<% end 96» 


<%= render partial: "ad", collection: Qadvertisements %> 
TASBINFÄ * HH Rails 对 泻 当 集合 做 了 一 些 优化 ， 性 能 会 变 快 一 点 。 
A : 泻 染 集合 时 ， 尽 量 不 要 省 略 :partial 参数 。 
其 它 


Controller 里 可 以 render 完整 的 模板 (template)、 或 局 部 模板 (partial)， 但 View 里 
不 可 指定 泻 染 完整 的 模板 (template). 


页 面 里 泻 染 js.erb 有 时 候 会 有 安全 隐患 ， 所 以 浑 染 后 用 escape javascript 处 
理 。 


spacer template 在 泻 染 之 间 穿 插 东 西 有 时 挺 方便 的 ， 例 如 奇偶 不 同时 我 们 设置 
BR ERE] 


Translation 


118n 相关 的 t & translate 和 1 & localize 方法 。 


IX #1 F Active Model 的 Translation 模块 。 


Collector 


我 们 在 respond to 里 可 以 响应 的 格式 Mime. 


Collector 是 Abstact Controller 实现 的 。Action Controller 有 自己 的 扩展 ，Active 
Mailer 也 有 自己 的 扩展 。 


对 应 : 
# action Ed 
respond to do |format | 
format.html 


format.xml { render xml: @people } 
end 


调用 format.html 和 format.xml 等 方法 调用 时 会 触发 method missing * 
之 后 由 generate method for mime 元 编程 生成 。 


另外 ， 如 果 请 求 没有 指定 格式 ， 响 应 默认 会 按 format 里 顺序 执行 ， 所 以 注意 一 下 顺 
序 。 像 一 些 搜索 引擎 就 没有 指定 请 求 格式 ， 所 以 一 般 的 放 format.html 在 前 
TM 


目前 Rails 支持 的 MIME( 多 用 途 互联 网 邮件 扩展 )， 有 : 
html text js css ics csv vcf 
png jpeg gif bmp tiff 
mpeg 
xml rss atom yaml 
multipart form url encoded form 
json 
pdf zip 


可 以 在 action_dispatch/http/mime_types.rb 里 查看 。 


Collector 
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其 它 


Abstract Controller 部 分 模块 在 前 面 已 经 详细 介绍 了 了， 下面 对 其 余 模 块 做 简单 描 
述 ， 有 利于 对 源码 的 阅读 。 


Asset Paths 


以 声明 的 形式 ， 定 义 一 些 assset 相关 的 类 方法 和 实例 方法 。 


config accessor :asset host, :assets dir, :javascripts dir, 





:stylesheets dir, :default asset host protocol, 
:relative url root 


Routes Helpers 
引入 Route 78 & x path £e x url 辅助 方法 。 


这 里 只 是 引入 ， 这 些 方法 在 RouteSet 里 定义 。 


include Rails.application.routes.url helpers 


之 后 ， 就 能 调用 和 Routing 相关 的 helper 方法 。 


routes.rb 里 定义 的 每 一 个 路 由 规则 都 会 有 对 应 的 x_url 和 x_path 等 helper 方 
法 可 用 ， 这 里 include 了 这 些 helper 方法 。 


然后 ，Action Controller 和 Action Mailer 的 Railtie 又 extend Routes Helpers， 所 
以 可 用 。 


Logger 


提供 logger 方法 打印 日 志 。 


Ur-For 


简单 封装 了 ActionDispatch::Routing::UrlFor > 8% 25 Active Mailer 和 
ActionController::UrlFor 使 用 。 


也 就 是 说 ，Action Controller 和 Action Mailer 在 这 里 没有 直接 与 Action Dispatch 
沟通 。 


Caching 


perform caching &c E 4 @ 8 MË * cache store 配置 启用 何 种 缓存 方式 。 


页 面相 关 服 务 端 缓存 
片段 缓存 相关 ， 在 这 里 可 以 单独 拿 出 来 讲 。 


页 面相 关 的 服务 端 缓存 ， 由 两 个 模块 组 成 : Caching 和 Caching Fragments. 


Caching 模块 


e cache store 有 没有 到 位 
e cache 相关 perform caching 是 否 使 用 
e 视图 缓存 依赖 


除 以 上 外 ， 它 几乎 什么 也 没 做 ， 定 义 了 cache 同名 方法 ， 保 证 了 执行 缓存 需要 的 


两 个 条 件 : perform caching = true 并 且 cache store 是 合法 的 。 


def cache(key, options = {}, &block) 
if cache configured? 
cache store.fetch(ActiveSupport: :Cache.expand cache key(key, 
:controller), 
options, &block) 
else 
yield 
end 
end 


p p M—— Par |) 


1) 想 要 关闭 片段 缓存 ， 可 以 配置 (开发 环境 下 默认 就 是 false) : 


config.action controller.perform caching = false 


2) Caching stores 


配置 怎么 存储 缓存 (默认 使 用 MemoryStore): 


config.action controller.cache store - :memory store 


config.action controller.cache store - :file store, '/path/to/ca 
che/directory' 

config.action controller.cache store - :mem cache store, 'localh 
ost' 

config.action controller.cache store - :mem cache store, 


Memcached::Rails.new('l 
ocalhost:11211') 
config.action controller.cache store = MyOwnStore.new( parameter ' 


) 
zz | 


3) view_cache_dependencies 


Caching Fragments 模块 


对 片段 缓存 的 一 些 操作 。 
这 里 的 方法 属于 中 间 处 理 过 程 ， 封 装 对 底层 的 操作 (也 就 是 cache store )， 然 后 
提供 接口 给 我 们 上 层 使 用 (也 就 是 cache 辅助 方法 ) 。 


cache 辅助 方法 
| 
V 
write fragment & read fragment 等 


| 
V 


cache store 


提供 了 这 么 几 个 方法 : 


fragment cache key 
fragment exist? 


read fragment 
write fragment 


expire fragment 


expire fragment 你 可 以 手动 指定 片段 缓存 过 期 的 规则 : 


expire fragment(controller: 'products', action: 'recent', 
action suffix: 'all products') 


操作 这 几 个 方法 的 是 controller， 而 这 个 几 方 法 操作 的 是 cache store. 


Note: ActionView::Helpers::CacheHelper 里 的 cache 方法 用 到 了 
read fragment ` write fragment 和 fragment cache key. 


SUA A BOR RU 


视图 包含 两 类 内 容 : Controller 传递 过 来 的 实例 变量 (动态 内 容 ， 必 需 手动 设置 )， 本 
身 的 静态 内 容 (自动 设置 )。 缕 存 要 考虑 这 两 种 内 容 的 更 新 。 


还 有 就 是 视图 里 的 显示 是 层 层 获 套 的 ， 它 们 之 间 有 时 候 是 有 关联 的 ， 这 种 情况 也 要 


怎么 生成 的 Cache Key? 默认 策略 是 路 径 + 动态 内 容 Cache Key + 静态 内 容 
Cache Key : 


views/projects/123-20120806214154/7a1156131a6928cb0026877f8b749a 
c9 
^class ^id ^updated at ^template tree digest 


第 一 次 访问 ( 读 缓存 失败 ， 写 缓存 ) 


Cache digest for 

app/views/posts/show.html.erb: a357e54a8e1fdeff463f2da17cdc8197 
Read fragment 
views/posts/1-20140421062215459004000/a357e54a8eifdef F463F2da17c 
dc8197 

Write fragment 
views/posts/1-20140421062215459004000/a357e54a8eifdef F463F2da17c 
dc8197 


第 二 次 访问 ( 读 缓存 成 功 ) 


Cache digest for 

app/views/posts/show.html.erb: a357e54a8e1fdeff463f2da17cdc8197 
Read fragment 
views/posts/1-20140421062215459004000/a357e54a8eifdef F463F2da17c 
dc8197 


查看 一 下 动态 内 容 的 cache key > 712 xt Hi 


post.cache key 


# => "posts/1-20140421062215459004000" 


38 PARS PRX ARRA SRA: 动态 内 容 这 部 分 Cache Key TÈ) 


Cache digest for 

app/views/posts/show.html.erb: 6e30019bd1127688840f 7307cbe5cfbc 
Read fragment 
views/posts/1-20140421062215459004000/6e30019bd1127688840f 7307cb 
e5cfbc 

Write fragment 
views/posts/1-20140421062215459004000/6e30019bd1127688840f 7307cb 
ebcfbc 


更 改动 态 内 容 (在 这 里 是 update post. ZG AX > SAF: 静态 内 容 这 部 分 Cache 
Key 不 变 ) 


Cache digest for 

app/views/posts/show.html.erb: 6e30019bd1127688840f7307cbe5cfbc 
Read fragment 
views/posts/1-20140421064029939882000/6e30019bd1127688840f 7307cb 
ebcfbc 

Write fragment 
views/posts/1-20140421064029939882000/6e30019bd1127688840f 7307cb 
e5cfbc 


如 何 才能 完全 手动 管理 缓存 ? (也 许 永 远 都 没 必 要 这 么 做 ) : 


1. 不 要 使 用 动态 内 容 做 key 
2. 关闭 静态 内 容 加 密 
比如 : 


cache 'all available products', skip digest: true 


此 时 : 


默认 片段 缓存 策略 


expire fragment('all available products') 
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Action Controller 


TODO 


Metal - 277% 4) Rack, fà 349 Controller 


加 强 的 Rack 


意味 着 它 符 合 Rack 接口 规范 ， 可 以 直接 使 用 它 ， 创 建 出 来 的 应 用 可 以 看 做 是 一 个 
Rack application. 


在 Rack 的 基础 上 ， 它 增加 了 middleware stack 的 预 处 理 。 


fe Rack 一 样 ， 它 的 功能 站 的 很 有 限 。 如 你 的 项 目 做 为 API 对 外 提供 服务 ， 不 需要 
那么 多 功能 ， 你 可 以 尝试 。 


fe Rack 一 样 ， 相 对 来 说 它 的 性 能 比较 高 。 如 你 的 Rails 项 目 对 性 能 要 求 非常 高 ， 
你 可 以 尝试 。 


Rails Metal is a subset of Rack middleware 可 以 参考 [Rack - Ruby Web 
server 接口 】 章 节 了 解 更 多 关于 Rack HAZ » 

简陋 的 Controller 

除了 提供 一 个 有 效 的 Rack 接口 外 ， 它 几乎 没有 任何 其 它 功能 。 


ActionController::Base 在 它 基础 之 上 添加 了 多 个 类 和 模块 ， 这 使 得 功能 得 到 增多 ， 
同时 在 性 能 上 也 会 有 相应 损耗 。 如 果 你 觉得 这 些 功能 不 是 必需 的 ， 或 者 性 能 的 损耗 
是 不 可 忍受 的 ， 你 可 以 直接 使 用 Metal. 


举 个 例子 : 


class HelloController < ActionController::Metal 
def index 
self.response body - "Hello World!" 
end 
end 


在 路 由 里 添加 相应 代码 ， 将 请 求 转 发 到 刚才 的 HelloController#index 进行 处 理 : 


# config/routes.rb 
get 'hello', to: HelloController.action(:index) 


A 1 ik Route 能 够 很 好 转发 ，action 方法 会 返回 一 个 有 效 的 Rack application. 


主要 做 的 事情 

调用 middleware 2t £1 TR 2 3. » 

4% Rack application 一 样 小 而 完整 的 处 理 。 

做 出 响应 。 

一 般 模块 名 和 同名 目录 都 是 有 联系 的 ， 但 metal 不 是 ， 它 单 指 的 是 metal.rb 这 个 文 

件 ， 和 metall 目录 下 的 文件 及 内 容 没有 关系 。 
e 直接 使 用 Metal 时 ， 要 清楚 自己 在 做 什么 。 

另外 ， 要 清楚 的 知道 各 个 组 件 有 什么 用 ， 添 加 是 为 了 什么 ， 去 掉 又 会 有 什么 影响 。 
e 为 什么 能 够 连续 调用 ， 原 因 : 


你 看 每 个 Rack Middleware 9 call HARET’ AEREA 
@app.call(env) ? 这 说 明 ， 它 在 调用 下 一 个 middleware. 


它们 是 一 条 封闭 的 链接 ， 一 直 走 下 去 ， 最 后 又 会 回 到 开头 处 ， 并 且 中 间 只 要 有 一 处 
断 了 ， 那 整 条 链子 就 都 走 不 通 。 


顺序 是 : 默认 是 按 use 的 顺序 走 下 去 ， 但 Use 时 你 也 是 可 以 指定 的 。 
Note: @app 和 env 内 容 一 直 在 变 ， 但 本 质 又 一 直 没 变 。 


不 再 推荐 使 用 字符 串 引 入 middleware 所 以 
middleware.use "Foo::Bar" 


middleware.use Foo::Bar 


Metal - 75 5& & Rack, 简陋 的 Controller 
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Metal 文件 下 的 内 容 
Metal 是 请 求 从 路 由 到 Controller 的 中 转 站 。 
类 方法 : 

action 


use 
middleware & middleware stack 


controller name 


实例 方法 : 


dispatch 


content type 
content type- 


location 
location- 


params 
params= 


status 
status= 


performed? 
response_body= 
controller_name 
env 


url for 


self.action 和 dispatch 为 转移 到 下 一 站 场 起 到 了 很 大 的 作用 。 


# Action Dispatch 转发 过 来 的 请 求 ， 要 先 经 过 层 层 的 middleware 处 理 ， 才 能 
到 达 指 定 的 action. 
def self.action(name, klass = ActionDispatch::Request) 
if middleware stack.any? 
middleware stack.build(name) do |env| 
new.dispatch(name, klass.new(env)) 
end 
else 
lambda { |env| new.dispatch(name, klass.new(env)) } 
end 
end 


从 堆栈 里 取 middleware # 4b 3€. » 


use 方法 把 middleware 3X ^. middleware stack » 44K € > 


class PostsController « ApplicationController 
use AuthenticationMiddleware, except: [:index, :show] 
end 


除 此 之 外 ， 需 要 清楚 : 


class attribute :middleware stack 
self.middleware stack - ActionController::MiddlewareStack.new 


Middleware Stack 


继承 于 Action Dispatch 的 MiddlewareStack > A + 4 2x middleware. 
它 的 功能 和 父 类 一 样 ， 只 是 作用 的 层面 不 同 。 


Middleware 并 不 总 是 需要 项 目 级 别 的 ， 它 也 可 以 精确 到 某 个 Controller， 甚 至 是 
action. 


class PostsController < ApplicationController 
use AuthenticationMiddleware, except: [:index, :show] 
end 


self.use 是 前 面 Metal 提供 的 方法 ， 可 以 添加 middleware 到 堆栈 ， 它 们 在 最 后 
执行 。 
(这 里 的 堆栈 指 的 可 以 是 ActionController::MiddlewareStack， 也 可 以 是 
ActionDispatch::MiddlewareStack). 


Metal 使 用 举例 


原生 的 Metal 


在 Rails €. metal 也 属于 middleware， 我 们 可 以 这 么 用 : 


# config/routes.rb 
get 'hello' => 'hello#index' 


H 
mr 


# app/controllers/hello controller.rb 
class HelloController « ActionController::Metal 
def index 
self.response body - "Hello World!" 
end 


然后 浏览 器 访问 : http://localhost:3000/hello 可 以 获取 刚才 的 内 容 。 


Started GET "/hello" for 127.0.0.1 at 2014-04-27 09:04:49 +0800 
Processing by HelloController#index as HTML 
Completed 200 OK in ims (ActiveRecord: 0.0ms) 


Started GET "/hello" for 127.0.0.1 at 2014-04-27 08:57:07 +0800 


加 入 Rendering 模块 


默认 ActionController::Metal 是 没有 提供 泻 染 视 图 、 模 板 和 其 它 需 要 明确 调用 到 
response_body=, content type=, status= 等 方法 。 如 果 你 需要 这 些 ， 可 以 引入 它 
43.3 


class HelloController « ActionController::Metal 
include AbstractController::Rendering 
include ActionView::Layouts 


append view path "#{Rails.root}/app/views" 


def index 
render "hello/index" 
end 
end 


加 入 Redirection 模块 


想 使 用 重 定向 相关 代码 ， 你 也 需要 引入 它们 : 


class HelloController < ActionController::Metal 
include ActionController::Redirecting 
include Rails.application.routes.url helpers 


def index 
redirect to root url 


end 
end 
加 入 其 它 模块 


参考 ActionController::Base 引入 其 它 模块 ， 以 达到 目的 。 


class ApiController < ActionController::Metal # 使 用 Metal, v 
Base 
include ActionController::Helpers 
include ActionController::Redirecting 
include ActionController::Rendering 
include ActionController::Renderers: :All 
include ActionController: :ConditionalGet 


# 需要 响应 .json .xml 等 不 同 格式 的 话 ， 使 用 它 。 
include ActionController::MimeResponds 
include ActionController::RequestForgeryProtection 
# 如 果 你 需要 SSL 

include ActionController::ForceSSL 

include AbstractController::Callbacks 

4 想 要 知道 Controller 处 理 过 程 中 ， 性 能 这 方面 的 数据 。 
include ActionController::Instrumentation 

# 需要 转换 params 类 型 的 话 ， 可 以 使 用 它 。 

include ActionController::Paramswrapper 
include Devise::Controllers::Helpers 


# 在 项 目 里 使 用 路 由 相关 的 helper 方法 。 
include Rails.application.routes.url helpers 


# 视图 文件 放 在 哪 ? 
append view path "#{Rails.root}/app/views" 


# 需要 转换 params 类 型 的 话 ， 可 以 使 用 它 。 
4 ( "person": ( "name": "Kelby", "email": "leekelbyQgmail.com" 


ir 


wrap parameters format: [:json] 


protect from forgery 
end 


上 述 代码 ， 仅 供 参 考 。 关 于 各 模块 及 其 作用 ， 详 情 可 以 参考 对 应 章节 。 
参考 


Developing api with rails metal 


Metal 使 用 举例 
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API - Metal 的 继承 者 


精简 版 的 ActionController::Base > 4 API 而 生 。 


它 没 有 也 不 需要 layouts 和 templates rendering, cookies, sessions, flash, assets 


e 默认 只 有 ApplicationController 继承 于 它 

e 没有 默认 演 染 。 所 以 需要 明确 指定 演 染 

e 除了 泻 染 ， 也 可 以 有 重 定向 

e 可 用 include 引入 其 它 模块 ， 比 如 MimeResponds 


它 和 ActionController::Base 本 质 上 是 一 样 的 ， 对 比 来 说 ， 它 去 掉 了 很 多 不 必要 的 
Metal 增强 组 件 ， 所 以 性 能 会 比较 快 : 


ActionController::API::MODULES 


MODULES = [ 
AbstractController: :Rendering, 


UrlFor, 

Redirecting, 
ApiRendering, 
Renderers::All, 
ConditionalGet, 
BasicImplicitRender, 
StrongParameters, 


ForceSSL, 
DataStreaming, 


AbstractController::Callbacks, 
Rescue, 
Instrumentation, 
ParamsWrapper 
MODULES.each do |mod| 


include mod 
end 


Ac 2. api only 
路 由 资源 默认 生成 几 个 action 
是 否 加 载 View 相关 的 dependencies rake 


是 否 采 用 几 个 middleware 


generator 少 生 成 几 个 目录 


Base - Metal 的 继承 者 


相对 于 Metal， 它 包含 了 各 个 控制 器 上 能 够 使 用 到 的 组 件 。 所 以 使 用 它 时 ， 在 性 能 
上 会 比 直接 继承 使 用 Metal 慢 得 多 ， 但 我 们 可 用 的 功能 更 丰富 了 。 


我 们 看 看 ActionController::«Base 引入 了 哪些 模块 : 


ActionController::Base::MODULES 


MODULES - [ 
AbstractController::Rendering, 
AbstractController::Translation, 
AbstractController::AssetPaths, 


Helpers, 

UrlFor, 

Redirecting, 
ActionView::Layouts, 
Rendering, 
Renderers::All, 
ConditionalGet, 
EtagwithTemplateDigest, 
RackDelegation, 
Caching, 
MimeResponds, 
ImplicitRender, 
StrongParameters, 


Cookies, 

Flash, 

RequestForgeryProtection, 

ForceSSL, 

Streaming, 

DataStreaming, 
HttpAuthentication::Basic::ControllerMethods, 
HttpAuthentication::Digest::ControllerMethods, 
HttpAuthentication::Token::ControllerMethods, 


AbstractController::Callbacks, 
Rescue, 
Instrumentation, 
Paramswrapper 
MODULES.each do |mod| 


include mod 
end 


引入 了 这 么 多 模块 ， 虽 然 方便 了 使 用 。 但 有 的 模块 ， 我 们 用 不 到 ， 浪 费 了 。 
如 果 对 性 能 有 很 高 要 求 ， 并 且 知 道 各 个 模块 作用 的 话 ， 可 以 适当 去 掉 某 些 模块 。 


后 文 讲 到 的 【API】 是 精简 版 的 Base， 它 也 是 直接 继承 于 Metal， 在 API 模式 
里 可 用 。 


Metal 的 增强 模块 


有 一 些 模块 和 Metal 一 样 也 有 process action 方法 ， 并 且 它 们 也 被 include 进 
了 Action Controller， 并 且 我 们 自己 定义 的 类 没有 重 写 这 个 方法 。 


根据 Ruby 的 代码 执行 规则 ， 执 行 process. action 时 它们 都 会 被 执行 (并 且 这 个 方 
法 执行 顺序 先 于 Metal 同名 的 方法 ) 。 


源 代码 里 ，Metal 仅 代表 metal.rb 这 个 文件 ， 不 包括 与 其 同名 的 metal 目录 。 
1) 继承 Abstract Controller 的 财富 

由 Metal 到 Base 继承 而 来 。 

2) 使 用 Action Dispatch 的 资源 

主要 是 Action Dispatch 的 http 和 middleware 下 的 内 容 。 

包括 但 不 限于 : 


处 理 request ^ response 相关 和 headers 78 X » (Metal 也 可 以 做 ， 但 这 里 得 到 了 充 
分 利用 ) 


3) 协作 Action View 

有 很 多 类 似 的 方法 或 丝 丝 关 联 ， 比 如 : io 

4) 少量 的 Active Model 

为 了 约定 优 于 配置 ， 很 少 的 一 部 分 方法 和 Active Model 的 Naming 模块 有 关联 。 


包括 但 不 限于 : 
wrap_parameters 


polymorphic url 
polymorphic path 


5) 提供 很 多 方法 ， 允 许 你 在 Controller 或 action 里 处 理 请 求 ， 并 响应 。 


Metal 的 增强 模块 
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Redirecting 


redirect to 


redirect back 


重要 的 部 分 就 是 可 以 根据 不 同 的 可 选 参 数 ， 计 萌出 要 重 定向 的 url. 


使 用 举例 : 


redirect to "www.rubyonrails.org" 
redirect to "/images/screenshot. jpg” 
redirect to articles url 


: back 


redirect to :back 


# Proc 


redirect to proc ( edit post url(Qpost) } 


& record WR 


redirect to post 


# Hash 

redirect_to action: “show”, id: 5 

redirect_to({ action: 'atom' }, alert: "Something serious happen 
ed" ) 


相关 、 类 似 功 能 : 


url for 根据 给 定 的 参数 和 default url options 和 routes.rb 里 的 路 由 定义 ， 生 
成 可 用 的 url. 


polymorphic url 根据 传递 的 record 对 象 ， 构 建 可 用 的 url. 


极端 情况 下 ， Tx: 


redirect to 
| 
V 
ActionController::UrlFor 
| 
V 
url for 
| 
V 
AbstractController::UrlFor 
| 
V 
ActionDispatch::Routing::UrlFor 
| 
V 
ActionDispatch: :Routing: :PolymorphicRoutes 
| 
V 
polymorphic url 
| 
V 


redirect back 相当 于 来 的 _ redirect to :back 但 它 可 接受 
:fallback location 参数 ， 以 应 对 Referer 不 存在 的 问题 。 


Head 


返回 一 个 内 容 为 空 的 response. 


有 时 候 (作为 Web service 时 )， 响 应 内 容 可 能 只 需要 一 个 状态 码 ， 其 它 内 容 都 不 需 
要 。 


直接 用 head 方法 : 


head :created, :location => person url(Qperson) 


注意 : 使 用 head 只 是 设置 了 respond _ body， 如 果 程 序 还 没有 结束 ， 那 么 
Controller#action 层面 的 后 续 代码 还 是 会 执行 的 。 


结果 和 使 用 render nothing: true 类 似 ， 所 以 你 也 可 以 这 么 做 : 


headers['Location'] = person url(Qperson) 
render :nothing -» true, :status -» "201 Created" 


当然 ， 如 果 有 多 个 地 方 使 用 到 此 功能 的 话 ，render 写 起 来 还 是 捍 让 人 头疼 的 。 


附 : 对 照 表 
Response Class HTTP Status Code Symbol 
消息 100 :continue 
101 :switching protocols 
102 :processing 
成 功 200 :0 
201 :created 
202 :accepted 
203 :non authoritative information 
204 :no. content 
205 :reset content 


206 :partial content 


207 
208 
226 
300 
301 
302 
303 
304 
305 
306 
307 
308 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 


:multi status 
:already reported 

:im used 

:multiple choice 

:moved permanently 
‘found 

:see other 

:not. modified 

:use proxy 

‘reserved 

:temporary. redirect 
:permanent redirect 

:bad reques 
:unauthorized 

:payment required 
‘forbidden 

:not. found 
:method not allowed 
:not. acceptable 

:proxy authentication required 
:request timeout 

:conflict 

:gone 

:ength required 
:precondition failed 
:request entity too large 
:request uri too long 
:unsupported media type 
:requested range not satisfiable 


:expectation failed 


422 
423 
424 
426 
428 
429 
431 
500 
501 
502 
503 
504 
505 
506 
507 
508 
510 
511 


:unprocessable entity 
‘locked 

:failed dependency 
:upgrade required 
:precondition required 

:too many requests 
:request header fields too large 
internal server erro 

:not implemented 

:bad gateway 

:service unavailable 
:gateway timeout 

:http version not supported 
:variant also negotiates 
"insufficient storage 

:|oop detected 

:not. extended 


:network authentication required 


Conditional Get - HTTP Cache 


页 面相 关 的 客户 端 缓存 


根据 ETag 和 Last-Modified 来 决定 是 否 泻 染 页 面 ， 可 充分 利用 客户 端 (例如 浏览 器 ) 
的 缓存 ， 在 Rails 里 属于 Controller#action 层面 的 缓存 。 


它 和 Rails.cache 等 缓存 机 制 都 不 一 样 ， 它 用 的 是 状态 头 和 浏览 器 的 特性 ， 并 不 属 
于 应 用 层面 的 缓存 。 


类 方法 : 


etag 


etag 把 缓存 元 素 加 入 到 etaggers €. » 2G cache 相关 的 方法 会 调用 到 
文 些 缓存 元 素 )， 进 而 通过 它们 影响 HTTP 缓存 结果 。 
里 添加 的 元 素 对 当前 Controller 下 所 有 的 action 都 会 起 作用 。 


实例 方法 : 


fresh when 


expires in 
expires now 


stale? 


http cache forever 


Rails 5 新 增 100 年 才 过 期 的 http. cache. forever 


fresh when 根据 传 入 的 参数 ， 设 置 response 里 和 HTTP RFA KN FH? # 
完成 响应 。 只 对 当前 action 起 作用 ， 用 到 了 上 面 提 到 的 etaggers > Ya ETag 和 
last modify 的 值 。 


stale? 不 只 是 单纯 的 询问 ， 它 用 到 了 fresh_when， 所 以 除了 返回 boolean 外 ， 
还 会 影响 response. 


fresh when 和 stale? 都 可 以 传递 template 参数 以 便 指 定 模板 。( 这 部 分 
由 【Etag With Template Digest】 进 行 处 理 ) 


expires in 设置 response 里 和 HTTP 缓存 有 关 的 字段 。 
expires now 设置 response 里 和 HTTP 缓存 有 关 的 字段 。 


注意 : HTTP 缓存 有 关 的 字段 有 多 个 ， 它 们 设置 的 是 不 同 字段 ， 或 同 字段 但 不 同 
值 。 


使 用 举例 : 


7 3 ns 
PX UA ? 


(Ai 
Or 
3x 
[5% 
® 
© 
© 
o 
[mu 


4 默认 传递 @post 给 posts/show 模板 进行 求 值 ， RAZ 
给 widges/show 求 值 
fresh when @post, template: 'widgets/show' 


# 只 对 @post 求 值 ， 不 带 入 模板 内 容 
fresh when Qpost, template: false 


id m — Rl 


shes, HTTP header 里 的 etag 和 last modified 就 意味 着 当 所 请 求 的 资源 没有 更 
过 时 ，Rails 可 以 返回 一 个 的 响应 。 这 可 以 节省 你 的 带宽 资源 和 时 间 。 


Note: 一 般 的 ，etag 相关 设置 只 是 节省 了 中 间 数 据 传输 的 网 络 资源 ， 但 在 服务 
器 上 的 计算 并 没有 减少 。 


Rails 5 可 传递 集合 给 fresh when 或 stale? 
例如 : 


# 之 前 
def index 
Qarticles - Article.all 
fresh when(etag: Qarticles, last modified: @articles.maximum(: 
updated at)) 
end 


# 之 后 
def index 
Qarticles - Article.all 
fresh when(Qarticles) 
end 


Conditional Get - HTTP Cache 
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Conditional Get 其 它 


相关 概念 
1) ETag 过 程 如 下 : 


。 窜 户 端 请 求 一 个 页 面 人， 服务 器 返回 页 面 A， 并 在 给 A 加 上 一 个 ETag. 
e 客户 端 展 现 该 页 面 ， 并 将 页 面 连同 ETag 一 起 缓存 。 
oe 客户 再 次 请 求 页 面 A， 并 将 上 次 请 求 时 服务 器 返回 的 ETag 一 起 传递 给 服务 


er 
o 
na 


R4 器 检查 该 ETag， 并 判断 出 该 页 面 自 上 次 客户 端 请 求 之 后 还 未 被 修改 ， 
接 返 回响 应 304 (未 修改 一 一 Not Modified) 和 一 个 空 的 response body. 


jh 


e 
zm 


2) Last-Modified it #240 F : 


在 浏览 器 第 一 次 请 求 某 一 个 URL 时 ， 服 务 器 端的 返回 状态 会 是 200， 内 容 是 客户 
端 请 求 的 资源 ， 同 时 有 一 个 Last-Modified 的 属性 标记 此 文件 在 服务 期 端 最 后 被 修 
改 的 时 间 ， 格 式 类 似 这 样 : 


Last-Modified : Fri , 12 May 2006 18:53:33 GMT 


客户 端 第 二 次 请 求 此 URL 时 ， 根 据 HTTP 协议 的 规定 ， 浏 览 器 会 向 服务 器 传送 下 
Modified-Since 报头 ， 询 问 该 时 间 之 后 文件 是 否 有 被 修改 过 : 


If-Modified-Since : Fri , 12 May 2006 18:53:33 GMT 


如 果 服 务 器 端的 资源 没有 变化 ， 则 自动 返回 HTTP 304 (Not Changed) 状态 码 ， 内 
容 为 室 ， 这 样 就 节省 了 传输 数据 量 。 当 服务 器 端 代码 发 生 改 变 或 者 重启 服务 器 时 ， 
则 重新 发 出 资源 ， 返 回 和 第 一 次 请 求 时 类 似 。 从 而 保证 不 向 客户 端 重复 发 出 资源 ， 
也 保证 当 服 务 器 有 变化 时 ， 客 户 端 能 够 得 到 最 新 的 资源 。 


3) 一 个 典型 的 Response headers: 


Last-Modified: Sun, 09 Nov 2014 05:25:32 GMT 
Etag: "4808a7a249c9fd981be8ba390f55ce8a" 


Cache-Control: max-age-0, private, must-revalidate 
Set-Cookie: sample app session-some-thing963D963D- -some-thing-els 
e; path-/; HttpOnly 

X-Request-Id: 02d61994-90aa-41e4-be96-b65b68914c13 
X-Runtime: 0.005787 

Server: thin 1.6.2 codename Doc Brown 

Date: Sun, 09 Nov 2014 05:42:53 GMT 
X-Frame-Options: SAMEORIGIN 

X-Xss-Protection: 1; mode=block 
X-Content-Type-Options: nosniff 

Content-Type: text/html; charset-utf-8 
Content-Length: 665 


和 所 有 缓存 一 样 ， 怎 么 生成 cache key ? 


最 新 ， 什 么 也 没 改 。 


f9d7568ac634fc9ad270f2348d5f3b41 


更 改 表态 内 容 : 


d9cc40e9e225a3e738c68b01f17ef4b0 
update columns 7128cbb34d84aa096ee62d69d1599a32 
update attributes 98eac754b15c61f4c8b4f79b7f0a5645 


Note: 默认 动态 或 静态 内 容 有 变 ，ETag 都 会 更 新 ; 都 不 改变 ， 才 不 更 新 。 如 果 
手动 设置 了 fresh when 反而 会 获取 到 日 数据 。 


如 果 fresh. when 匹配 ， 将 直接 返回 结果 给 最 终 用 户 。 但 后 面 的 代码 并 未 退出 ， 还 
会 执行 ， 只 到 遇 到 结束 标识 为 止 。 也 就 是 说 Controller#action 后 续 有 代码 的 话 ， 则 
还 会 执行 ， 但 View 里 的 代码 不 会 执行 了 


这 里 区 别 于 响应 : 


# 之 前 


Completed 200 OK in 84ms (Views: 10.7ms | ActiveRecord: 2.7ms) 


Tode dh oo Suc TE 
2 还 m Rs ZR AL 图 


# 之 后 ， 不 需要 泻 娄 视图 


Completed 304 Not Modified in 3ms (ActiveRecord: 0.1ms) 


相关 代码 


fresh_when 方法 : 


def fresh when(record or options, additional options = {}) 

Bo... AAAH > 

# 设置 response 部 分 属性 

response.etag = combine etags(options) if options[:etag] || op 
tions[:template] 

response.last modified = options[:last modified] if options[:1 
ast modified] 

response.cache control[:public] = true if options[:p 
ublic] 


# 调用 head 方法 ， 返 回 状态 码 304 


head :not modified if request.fresh?(response) 
end 


可 选 参数 etag ^ template ^ last modified 和 public. 


head Zik: 


def head(status, options = {}) 
& ... 设置 status^location^ content type ^ * % 


if include content?(self. status code) 
self.content type - content type || (Mime[formats.first] if 
formats) 
self.response.charset - false if self.response 
self.response body - " " 
else 
headers.delete('Content-Type') 
headers.delete('Content-Length') 
self.response body = "" 
end 
end 


request.fresh? 方法 : 


def fresh?(response) 
last modified - if modified since 
etag - if none match 


return false unless last modified || etag 


success - true 

success &&- not modified?(response.last modified) if last modi 
fied 

success &&- etag matches?(response.etag) if etag 

success 
end 


fresh when 可 以 通过 工具 (如 : Chrome 插件 "Advanced REST client") & £ ETag ， 
仿 测 是 否 起 作用 以 及 是 否 正 确 。 


Conditional Get - HTTP Cache 


Note: ETag 和 已 经 被 废除 cache page 的 区 别 ， 前 者 是 Web 服务 器 级 别 ， 后 
者 是 应 用 服务 器 级 别 。 如 果 页 面 没 有 更 改 ，ETag 返回 的 是 "304 Not 
Modified"， 其 他 什么 都 不 用 干 ， 连 网 络 带 宽 都 省 了 。cache page 还 要 读 取 
public) 目录 下 的 静态 HTML 文件 ， 减 少 了 计算 过 程 ， 但 还 是 需要 网 络 传输 页 面 
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Etag With Template Digest 
用 Digestor 25 2: ay $$ A 72 JA (*1 controller name/action name)Ze & > ££ Z 45 
成 Etag 的 一 部 分 。 


前 面 提 到 的 fresh when 匹配 的 只 是 动态 内 容 。 静 态 内 容 怎 么 生成 cache_key ， 
怎么 过 期 ? (比如 开发 环境 下 ， 我 们 会 经 常 修改 静态 内 容 ) 


答案 是 : 给 静态 内 容 做 md5 加 密 。 每 一 次 更 改 静 态 内 容 ， 对 应 的 Hash 值 都 会 改 
变 。 在 开发 环境 下 ， 每 次 更 新 都 会 刷新 页 面 ; 在 生产 环境 下 ， 重 启 服务 器 后 会 刷 
新 。 


默认 该 特性 已 启用 ， 也 就 是 说 Action View 静态 内 容 已 经 加 密 ( 区 别 于 片段 缓存 里 对 
静态 内 容 的 加 密 ) 。 


可 以 设置 取消 : 
config.action controller.etag with template digest = false 
取消 后 ， 静 态 内 容 不 经 过 加 密 ， 更 改 它们 ，Hash 值 并 不 会 更 改 。 就 会 导致 生产 环 


境 下 ， 即 使 重启 服务 器 得 到 的 还 是 原来 的 内 容 。 


本 设置 影响 的 是 ETag， 缓 存 的 是 当前 用 户 浏览 的 内 容 ， 他 人 或 使 用 新 浏览 器 访问 
页 面 ， 不 受 影 响 。 


用 到 了 ConditionalGet::etag 和 Digestor'::digest， 注 意 它 只 用 于 条 件 判 断 ， 本 身 不 
会 更 改 内 容 。 


3 个 级 别 的 验证 ， 分 别 是 Basic、Digest 和 Token. 
设置 头 部 消息 "WWW-Authenticate"， 获 取 headers["WWwW-Authenticate"] 


我 们 最 最 常用 的 是 : 





authenticate or request with http basic(realm = "Application", & 
login procedure) 


Basic 
对 应 头 部 字段 及 内 容 : 


headers["WwW-Authenticate"] = %(Basic realm="#{realm.gsub(/"/, "" 
22e) 
E mme Ini 








http basic authenticate with 


使 用 举例 : 


class PostsController < ApplicationController 
http basic authenticate with name: "dhh", password: "secret", 
except: :index 


def index 
render plain: "Everyone can see me!" 
end 


def edit 
render plain: "I'm only accessible if you know the password" 
end 
end 


http basic authenticate with 除 :name 和 :password 选项 外 ， 一 般 还 可 设 
i :realm 做 为 提示 信息 。 它 已 经 封装 了 authenticate or request with http basic 
方法 。 


http basic authenticate with 最 常用 的 验证 方式 。 


Controller 方法 : 


authenticate with http basic 





request http basic authentication 


authenticate or request with http basic 





authenticate or request with http basic 





使 用 举例 : 


简单 的 封装 了 其 余 两 个 方法 。 


class ApplicationController « ActionController::Base 
before action :set account, :authenticate 


protected 
def set account 
@account = Account.find by(url name: request.subdomains.fi 
rst) 
end 


def authenticate 
case request.format 
when Mime::XML, Mime::ATOM 
# 使 用 验证 





if user = authenticate with http basic do |u, p| 
@account.users.authenticate(u, p) # <- 过 里 
end 


Qcurrent user - user 


else 
# 使 用 验证 
request http basic authentication # <- 这 里 
end 
else 


if session authenticated? 
Qcurrent user - Qaccount.users.find(session[:authentic 
ated][:user. id]) 
else 
redirect to(login url) and return false 
end 
end 
end 
end 


其 它 方 法 : 


auth param 
auth. scheme 


authenticate 


authentication request 


decode credentials 
encode credentials 


user name and password 


has basic credentials? 


使 用 举例 : 


def test access granted from xml 
get( 
/notes/ xm na 
'HTTP_AUTHORIZATION' => 
ActionController::HttpAuthentication::Basic.encode credenti 
als( 
users(:dhh).name, 
users(:dhh).password 


assert equal 200, status 
end 


Digest 
对 应 头 部 字段 及 内 容 : 
headers["WWW-Authenticate"] = %(Digest realm="#{realm}", qop="au 


th", algorithm=MD5, 
nonce="#{nonce}", opaque="#{opaq 


ue}" ) 


Controller 方法 : 


提供 方法 : 


authenticate with http digest 
request http digest authentication 





authenticate or request with http digest 





使 用 举例 : 


require 'digest/mdb5' 


class PostsController « ApplicationController 
REALM - "SuperSecret" 
USERS = {"dhh" => "secret", 
# plain text password 


# hal digest password 
"dap" => Digest::MD5.hexdigest(["dap", REALM, "secret" 


].join(":"))} 


before_action :authenticate, except: :index 


def index 


render plain: 


end 


def edit 


render plain: 


end 


private 


"Everyone can see me!" 


"I'm only accessible if you know the password" 


def authenticate 


# 使 用 验证 


authenticate or request with http digest(REALM) do |userna 


me| # <- 这 里 





USERS [username] 


end 


authenticate or request with http digest 简单 的 封装 了 其 余 两 个 方法 。 
从 名 字 可 知 ， 如 果 提 供 的 是 普通 文本 则 直接 接受 ; 如 果 提 供 的 是 md5 Ze S WA 


(自动 ) 解 密 再 接受 。 


其 它 方法 : 





authenticate 
authentication header 
authentication request 


decode credentials 
decode credentials header 
encode credentials 


expected response 
hai 

nonce 

opaque 
secret_token 


validate_digest_response 
validate_nonce 


Token 
对 应 头 部 字段 及 内 容 : 


headers["WwW-Authenticate"] = %(Token realm="#{realm.gsub(/"/, "" 
ye) 
‘| 一 到 





Controller 方法 : 


提供 方法 : 


authenticate with http token 





request http token authentication 





authenticate or request with http token 


authenticate or request with http token 简单 的 封装 了 其 余 两 个 方法 。 





使 用 举例 : 


class PostsController « ApplicationController 
TOKEN = "secret" 


before_action :authenticate, except: :index 


def index 
render plain: "Everyone can see me!" 
end 


def edit 
render plain: "I'm only accessible if you know the password" 
end 


private 
def authenticate 
# 使 用 验证 
authenticate or request with http token do |token, options 





token -- TOKEN 
end 
end 
end 


class ApplicationController « ActionController::Base 
before action :set account, :authenticate 


protected 
def set account 
@account = Account.find by(url name: request.subdomains.fi 
rst) 
end 


def authenticate 
case request.format 
when Mime::XML, Mime::ATOM 
# 使 用 验证 





if user = authenticate with http token do |t, o| 
Qaccount.users.authenticate(t, o) 
end 


Qcurrent user - user 


else 
4 使 用 验证 
request http token authentication 
end 
else 


if session authenticated? 
Qcurrent user - Qaccount.users.find(session[:authentic 
ated][:user. id]) 
else 
redirect to(login url) and return false 
end 
end 
end 
end 


其 它 方法 : 


authenticate 
authentication request 


encode credentials 


params array from 


rewrite param values 


token and options 


raw params 
token params from 


传递 token 时 ， 可 以 传递 额外 的 数据 ， 如 : 


Authorization: Token token="abc", nonce="def" 


尖 后 使 用 token and options 获取 这 些 数据 。 


使 用 举例 : 


def test access granted from xml 
get( 
MY nobes xm nat, 
'HTTP. AUTHORIZATION' => 


ActionController::HttpAuthentication: 


als(users(:dhh).token) 
) 


assert equal 200, status 
end 


Token 验证 的 部 分 特点 


不 能 直接 明文 出 现在 url 里 。 


:Token.encode credenti 


1 
2. 通过 curl -H 'Authorization: Token token="x" 传递 数据 。 
3. 


通常 用 于 制作 程序 接口 。 


4. 不 提供 弹 窗 输入 ， 其 余 两 种 验证 方式 提供 。 


Streaming 
pcd S ONUS o 


Rails £i tÈ Je bo: 先是 模板 ， 然 后 是 数据 库 查 询 ， 最 后 才 是 布局 。 


HTTP request -> dynamic content generation -> static head genera 
tion -» HTTP response 


具体 一 点 : 它 先 执行 yield 里 的 内 容 ， 泻 染 模板 ， 最 后 才 是 加 载 assets/layouts. 


dem ep et a 5 
好 一 点 ， 还 有 就 是 这 会 使 得 JS 和 CSS 的 加 载 顺序 比 平时 提前 。 变 成 (这 里 只 是 类 
似 ) : 


HTTP request -> static head generation -> HTTP response 
-> dynamic content generation -> HTTP response 


头 部 消息 如 上 了 : 


Transfer-Encoding: chunked 


如 何 使 用 ? 


Streaming 没有 对 外 提供 方法 ， 在 render 的 时 候 ， 加 上 :stream 参数 即 可 : 


class PostsControlle: 
def index 
@posts = Post.all 
render stream: true # 仅 作用 于 模板 ，json、xml 等 格式 的 数据 不 行 
end 
end 
先 返回 HTML 的 head 部 分 ， 之 后 返回 body 部 分 ; 而 不 是 像 之 前 全 部 泻 染 完全 才 


一 起 返回 head 和 body. 
一 般 我 们 都 把 js 和 css Ahead 里 ， 这 意味 着 它们 会 先 于 页 面 内 容 返 回 。 


注意 事项 : 


>, 


注意 : 使 用 Streaming 特性 后 后 ，HTML 里 的 head 部 分 会 先 返回 ， 不 受 页 面 内 容 
的 影响 。 如 果 原 来 的 head 部 分 依赖 于 页 面 ， 需 要 做 对 应 修改 。 


举例 : WR title 是 根据 页 面 动 态 生 成 的 ， 使 用 Streaming 后 就 会 出 现 缺 失 的 
情况 ， 需 要 更 改 原 有 代码 。 可 以 改 成 使 用 provide 和 yield ; 


4 projects/index.html.erb 
<% provide :title, "Projects" 96 


# layouts/application.html.erb 
<title><%= yield :title %></title> 


再 举例 : 使 用 此 特性 后 ， 将 不 能 动态 生成 cookie 和 session AR e 
再 举例 : 并 不 是 所 有 应 用 服务 器 (例如 上 默认 的 Webrick) 都 支持 此 特性 。 


使 用 之 前 ， 请 搞 清 楚 它 要 解决 的 问题 ， 以 及 带 来 的 新 问题 。 还 有 ， 不 要 和 【Live】 
里 的 stream ÆA T ° 


Note: 可 通过 命令 curl -i localhost:3000 查看 使 用 效果 。 


Live 
实时 推送 消息 。 可 用 于 构建 实时 聊天 之 类 等 。 
尽量 不 要 和 Streaming 搅 在 一 起 ， 它 们 有 类 似 之 处 ， 但 不 要 混淆 了。 
默认 不 使 用 SSE 
默认 情况 下 不 使 用 SSE > mÆ Buffer， 举 例 : 
class MyController < ActionController::Base 
# 步骤 1 


include ActionController::Live 


def stream 


# DR 2 
response.headers['Content-Type'] = 'text/event-stream' 
100.times ( 


4 WH 3 直接 使 用 response.stream 
response.stream.write "hello world\n" 
sleep 1 

} 


ensure 
# PR 4 
response.stream.close 
end 
end 


建议 web server 使 用 gem 'puma'， 开 发 环境 下 默认 使 用 的 WEBrick 不 支持 。 
Unicorn( 响 应 比较 快 ， 并 且 对 超时 比较 严格 )、Rainbows! 或 Thin 也 可 以 。 


使 用 SSE 
SSE 全 称 Server Sent Event，HTML5 服务 器 发 送 事 件 。 


提供 方法 : 


close 


write 


使 用 举例 : 


class MyController < ActionController::Base 
# 步骤 1 
include ActionController::Live 


def index 
# DR 2 
response.headers['Content-Type'] = 'text/event-stream' 


# 步骤 3 sse HRT response.stream 
sse - SSE.new(response.stream, retry: 300, event: "event-nam 
e") 


4 步骤 4 
sse.write(( name: 'John'}) 
sse.write({ name: 'John'}, id: 10) 
sse.write({ name: 'John'}, id: 10, event: "other-event") 
sse.write({ name: 'John'}, id: 10, event: "other-event", ret 
ry: 500) 
ensure 
# 步骤 5 
sse.close 
end 
end 


实例 方法 


process 
set response! 
response body- 


log error 


process 常见 的 同名 方法 ， 这 里 主要 是 另 开 一 线程 进行 处 理 请 求 。 


set response! 也 是 常见 的 同名 方法 ， 这 里 主要 是 设置 response 为 
Live::Response 的 实例 对 象 。 


response_body= 主要 是 用 于 确保 response 用 完 后 关闭 。 
log error 记录 错误 (有 的 话 )。 
注意 事项 
e content for 根据 情况 ， 有 的 要 改 为 provide 
e 如 果 模 板 里 有 更 改 Headers, cookies, session and flash 的 值 ， 将 不 起 作用 
e 部 分 middleware 将 不 能 再 使 用 ， 如 : Rack::Bug ` Rack::Cache 
e 异常 报告 和 Web server 的 支持 
参考 


小 


#401 ActionController::Live 
Is it live? 


Mime Responds & Collector 
实例 方法 
respond to 


respond to(*mimes, &block) -全 部 内 容 ( 包 含 类 型 和 内 容 ) 


respond to 可 以 指定 format, 如 html. 而 在 format 里 又 可 以 指定 variant, 如 : 
phone. 


format.html.phone # 行内 风格 
#5 


format.html{ |variant| variant.phone } # 代码 块 风 格 


Collector 
扩展 了 AbstractController::Collector， 并 且 ， 增 加 了 对 "变种 "的 支持 。 


常用 代码 : 


respond to do |format | 
# format.class => ActionController::MimeResponds::Collector 


format.html 
format.js 
end 


*[ JL > respond to 里 的 format 是 其 实例 对 象 。 


Note: 想 知道 这 里 的 format.html 和 format.js 等 方法 是 如 何 生效 的 ， 
可 以 参考 Abstract Controller 的 【Collector】 章 节 。 


提供 方法 : 


all & any 
custom 
negotiate format 


response 


此 外 ， format.html 等 对 应 着 Collector， 而 变种 format.html.phone 等 对 应 
着 Variant Collector. 


有 时 候 ， 如 果 遇 到 出 错 ActionController::UnknownFormat ， 可 考虑 响应 所 有 格式 : 


respond to do |format | 

format.html { ... } 

format.all {render :text => "Only HTML supported"} 
end 


aua 


Renderers 72$ M 72 # Z5 
针对 respond to 里 面 不 同 的 format 会 有 不 同 的 泻 当 器 对 它们 进行 处 理 。 
实例 方法 : 


render to body 


render to body 在 其 它 地方 有 同名 方法 ， 执 行 泻 染 时 就 会 触发 它 ， 这 里 就 隐藏 
着 魔法 。 


还 有 实例 方法 _render to body_with_renderer， 在 实现 过 程 中 很 重要 。 
类 方法 : 
add 


remove 


1) 使 用 add 添加 泻 染 器 : 
ActionController::Renderers.add :csv do |obj, options| 
filename - options[:filename] || 'data' 
str = obj.respond to?(:to csv) ? obj.to csv : obj.to s 
send data str, type: Mime::CSV, 
disposition: "attachment; filename=#{filename}. 


csv" 
end 


2) 之 后 要 注册 : 
Mime::Type.register "application/csv", :csv 


(在 后 面 的 Mime Type register 章节 还 会 提 及 ) 


3) 使 用 刚才 添加 的 泻 染 器 : 


def show 
@csvable = Csvable.find(params[:id]) 


respond to do |format | 
format.html 
4 对 应 这 里 的 format.csv 


format.csv { render csv: Qcsvable, filename 
end 


ActionController::Renderers.remove(:csv) 
其 它 类 方法 : 
use renderer & use renderers 


默认 Action Controller # 857€ 3e 3B: 


ActionController::Renderers: : RENDERERS 
=> #<Set: {:json, :js, :xml}> 


: @csvable.name } 


Params Wrapper 


对 请 求 过 来 的 params 进行 预 处 理 。 通 过 API 发 送 请求 的 话 ， 使 用 它 ， 特 别 方便 。 


类 方法 : 
wrap_parameters 

比如 ， 实 际 发 送 的 是 : 
{"name": "Konata"} 

预 处 理 过 后 ， 可 以 变 成 : 


("user": ("name": "Konata")) 


E 
"Y 
RR 


{"name" => "Konata", "user" => {"name" => "Konata"}} 


或 变 成 其 它 样子 ， 数 据 类 型 也 可 以 改变 。 
开放 API 时 ， 此 特性 用 得 最 多 ， 此 时 请 求 格式 一 般 为 'application/json' 


使 用 举例 : 


# 默认 
wrap_parameters false 


# 原 params 复制 一 份 ， 使 用 :person 为 root 元 素 
wrap_parameters :person 


# 原 params 复制 一 份 ， 使 用 :person 为 root 元 素 
wrap_parameters Person 


4 原 params 复制 一 份 ， 转 化 成 XML 格式 ， 使 用 默认 的 root 元 素 
wrap parameters format: :xml 


# Æ params 复制 一 份 ， 但 只 要 :username 和 :title 部 分 ， 使 用 默认 的 root 
LR 


wrap_parameters include: [:username, :title] 


# /& params 复制 一 份 ， 但 排除 :title 部 分 ， 使 用 默认 的 root AK 
wrap_parameters :exclude => :title 


include root in json 一 个 功能 上 恰好 和 它 有 类 似 之 处 的 方法 (一 个 在 Active 
Model * 5 —4-4& Action Controller) ° 


Post.to json 


4 RA RA root =# 
(title: 'hello world') 


# 如 果 include root in json = true 
{"post": {title: 'hello world'}} 


Request Forgery Protection 
防止 - 跨 站 请 求 伪造 。 

请 求 伪 造 保护 。 

什么 伪造 ? 

跨 站 请 求 伪造 (CSRF)。 

怎么 保护 ? 

生成 字符 串 ， 放 session 里 ， 请 求 过 来 时 要 校 验 。 


类 方法 : 


protect from forgery 


方法 里 调用 了 : 


before action :verify authenticity token 


等 内 容 ， 使 用 举例 : 


class ApplicationC 


nntrn a 
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protect from forgery 


"EDISOEC CI OTISOG CIS 


skip before action :verify authenticity token, if: 


st? 


protected 


def 
request.format.json? 


json request? 


end 
end 


^ < ActionController::Base 


:ijson reque 


protect from forgery 可 选 参 数 :only ^ :except ` :with 和 :prepend 


当 请 求 未 证 实 ， 可 选择 怎么 处 理 。 可 选 : 


:exception # ğa ActionController::InvalidAuthenticityToken # 


Ed = 
:reset session # £E session. 
:null session # 使 用 空 的 session 代替 ， 但 不 删除 (这 是 默认 选择 ， 可 用 wi 


th 指定 ) 
实例 方法 : 
verify authenticity token 


handle unverified request 


当 请 求 未 证 实 ， 会 使 用 handle unverified request 来 处 理 。 对 应 上 面 的 


Exception ` Reset Session ` Null Session. 


由 两 部 分 组 成 : Parameters 和 Strong Parameters. 


Parameters 


Parameters 继承 于 Hash With Indifferent Access， 而 Hash With Indifferent 
Access 又 继承 于 Hash. 所 以 它 的 实例 对 象 类 似 于 Hash 的 实例 对 象 。 


提供 params 这 个 对 象 可 以 使 用 的 方法 (部 分 与 Hash 实例 方法 类 似 ) : 
permit 
require & required 
extract! 
permit! 
select! 
permitted? 


permitted- 


[] 


delete, dup 

each & each pair 
fetch 

to h 

slice 

transform values 


converted arrays 


我 们 可 以 在 Rails 之 外 创建 自己 的 params *t & : 
require 'action controller/parameters' 


params = ActionController::Parameters.new({ 
person: { 
name: 'Francesco', 
age: 22, 
role: 'admin' 
} 
}) 


# require(key) 和 permit(*filters) 方法 

permitted - params.require(:person).permit(:name, :age) 
permitted # => {"name"=>"Francesco", "age"=>22} 
permitted.class # => ActionController: :Parameters 

# permitted? 方法 

permitted.permitted? # => true 


Person.first.update!(permitted) 
# => #<Person id: 1, name: "Francesco", age: 22, role: "user"> 


可 以 直接 使 用 permit! 允许 更 新 指定 参数 : 


Quser.update attributes(params[:user].permit!) 


配置 默认 的 permitted parameters 


config.always permitted parameters = %w( controller action forma 
t) 


attributes.permitted? 5 ForbiddenAttributesProtection 

Base 4 API 都 有 include StrongParameters 并 且 仅 提供 params 和 
params= 方法 ， 所 以 有 理由 相信 在 Controller 和 View 里 通过 params 给 record 

对 象 属性 典 值 (AttributeAssignment) 的 话 ， 都 会 询问 一 遍 是 否 permitted? 如 果 

包含 未 被 允许 更 新 的 字段 ， 会 抛 ForbiddenAttributesError 错误 。 

Strong Parameters 

我 们 在 Controller 里 常用 的 params 就 是 这 里 提供 的 。 

params 实际 上 是 Parameters 实例 对 象 ， 我 们 可 以 对 它 的 属性 进行 读 、 写 操作 。 
params 


params= 


另外 ， 要 说 明 : 


params == request.parameters 


> Erue 


并 不 表明 它 和 request.parameters 是 完全 等 价 的 ， 后 者 是 
ActiveSupport::HashWithIndifferentAccess 实例 对 象 。 


这 个 对 象 的 值 是 什么 ?- 表单 数据 或 传递 过 来 的 ， 加 上 :controller 和 :action 


Parameters & Strong Parameters 


Processing by PostsController#create as HTML 
Parameters: {"utf8"=>"v", 

"authenticity token"-»"kJttlgy9ptyuFS5TXrE95HFwKdhf 
7p74yuFZ173Lvxg=", 

"post"=>{"title"=>"hello world"), 

"commit"=>"Create Post"} 


params 
=> {"utf8"=>"v", 

"authenticity_token"=>"kJttlgy9ptyurFS5STXrE95HFwKdhf7p74yurFZl 
73Lvxg=", 

"post"=>{"title"=>"hello world"), 

"commit"=>"Create Post", 

"action"=>"create", 

"controller"=>"posts"} 
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Data Streaming 


send data 
send file 


send data 类 似 render :text 
send file 类 似 response body = file 


它们 发 送 方式 类 似 ， 并 且 实 现 上 也 有 相同 的 send file headers! 


但 send data 可 以 发 送 的 是 数据 , 可 以 是 非 文 件 ， 也 就 是 说 即使 是 字符 串 也 可 
发 送 。( 比 如 动态 生成 的 内 容 ) 

而 send file 只 能 先 有 文件 ， 才 能 发 送 。 

相关 可 选 参 数 : filename ^ :type ` :disposition ` :status 或 :url based filename 可 


以 查看 API 文档 了 解 。 


一 般 的 ， 动 态 生 成 或 一 次 性 的 内 容 ， 使 用 send data 比较 好 ; 纯 文 件 或 内 容 可 供 多 
次 下 载 的 ， 使 用 send file 比较 好 。 


A? LIRR AZ > HA IRIE VAG Web 服务 器 (Nginx/Apache) 发 送 ， 应 用 只 
要 提供 URL 即 可 。 此 时 ， 仍 然 可 以 和 原来 一 样 调用 send file F iA > (2 AEH 
据 的 时 候 ，Web 服 务 器 会 自动 忽略 掉 应 用 服务 器 的 response. 


# config/environments/production.rb 

config.action dispatch.x sendfile header = "X-Sendfile" # for Ap 
ache 

config.action dispatch.x sendfile header = 'X-Accel-Redirect' # 


for NGINX 


Force SSL 
实例 方法 : 


force ssl redirect 


重 定向 到 https 链接 , url 会 改变 。 

重 定向 这 部 分 用 到 了 redirect to 方法 ， 提 供 可 选 参 数 :status, :flash, :alert, :notice 
如 果 没 有 (用 参数 ) 指 定 链接 ， 则 用 当前 链接 ， 但 会 以 https 协议 访问 。 可 用 于 注册 、 
登录 等 页 面 。 链 接 这 部 分 用 到 了 un for 方法 ， 提 供 可 选 参数 :protocol, :host, 
:domain, :subdomain, :port, :path 

上 面 是 实例 方法 ， 对 单个 action 有 用 ; 

下 面 这 是 类 方法 ， 它 封装 了 force ssl redirect， 对 整个 Controller 有 用 。 


类 方法 : 
force ssl 


可 指定 action 跳 转 ， 可 选 参数 only, :except ; 或 根据 条 件 跳 转 ， 可 选 参数 iif, 
:unless 


使 用 举例 : 


class AccountsController < ApplicationController 
force ssl if: :ssl configured? 


def ssl configured? 
!Rails.env.development? 
end 
end 


Flash 


Action Controller 和 Action Dispatch 都 有 Flash 相关 的 代码 。 


基本 使 用 


类 似 Hash， 设 置 flash 


class PostsController < ActionController::Base 
def create 
# save post 
flash[:notice] = "Post successfully created" 
redirect_to @post 
end 


def show 


类 似 Hash, ix FX flash 


4 show.html.erb 
<% if flash[:notice].present? %> 

«div class="notice"><%= flash[:notice] %></div> 
<% end 96» 


alert 和 notice 


I4 73 alert 和 notice 类 型 的 flash 太 常 见 ， 所 以 提供 了 语法 糖 ， 你 还 可 以 这 人 么 


写 : 


# 设置 
flash.alert = "You must be logged in" 
flash.notice = "Post successfully created" 


flash.alert 
flash.notice 


Note: 其 它 flash type 默认 不 能 这 么 写 


上 面 是 由 Action Dispatch 提供 ， 下 面 由 Action Controller 提供 。 


add flash types 方法 
觉得 上 面 的 写法 还 是 不 够 简短 ， 觉 得 notice 和 alert 类 型 不 够 用 ?使 用 


add flash types 


4 app/cotrollars/pplication controller.rb 

class ApplicationController « ActionController::Base 
add flash types :warning, :success, :danger 

end 


# View 代码 
<%= warning 96» 


# Controller 代码 
redirect to user path(Quser), warning: "Incomplete profile" 


两 种 效果 : 视图 里 可 以 直接 有 同名 warning 辅助 方法 ， redirect to 里 可 直 
接 使 用 :warning 


它们 和 flash[:warning] 或 flash.warning 和 flash: { warning: "Incomplete profile" Y 
效果 一 样 。 
还 是 alert 和 notice 


alert 和 notice 默认 已 经 使 用 add flash types 


经 验 : 默认 Rails 提供 了 上 述 类 型 的 flash， 实 际 情 况 中 一 般 是 不 够 用 的 〈 至 少 对 应 
红 、 黄 、 绿 ) 3 种 级 别 的 消息 。 所 以 ， 建 议 您 用 同样 的 方法 添加 自己 的 flash. 


flash.now[:flash type] 


也 许 ， 你 还 看 过 一 种 写法 flash.now[:flash type] 


flash[:flash_type] 消息 的 生命 周期 可 到 下 一 个 action. 所 以 ， 通 常 搭配 redirect to 
使 用 。 

flash.now[:flash_type] 消息 的 生命 周期 仅 限 于 本 action. 所 以 ， 通 常 搭配 render 使 
用 o 


以 update A 4| : 如 果 成 功 则 跳 转 到 新 页 面 ， 那 么 可 用 flash[:flash_type]; 失败 则 停 
留 在 当前 页 面 ， 那 么 可 用 flash.now[flash type]. 


另 ， 当 你 意外 的 发 现 提醒 消息 在 一 个 页 面 出 现 ， 在 下 一 个 页 面 还 是 出 现 ， 不 妨 改 为 
flash.now[:flash_type] 试 试 。 


Helpers 


helpers 


本 质 是 ActionView::Base 的 实例 对 象 : 


ApplicationController.helpers.class 


# => ActionView: :Base 


rails 控制 台 里 的 helper 方法 指 的 就 是 它 。 
除 上 述 方法 外 ， 还 有 : 

all helpers from path 

helper attr 


modules for helpers 


helper attr 用 到 了 AbstractController::Helpers 里 的 helper method 方法 。 


AN ARE: 


Rue 


config.action controller.include all helpers = false 


可 以 设置 单个 Controller 只 加 载 和 它 名 字 对 应 的 Helper 模块 ， 而 不 是 所 有 的 
Helper( 所 有 的 helper 方法 ) ° 


除 上 述 描述 外 ， 因 为 它 include AbstractController::Helpers 所 以 它 还 有 两 
个 比较 重要 的 方法 可 用 。 


Cookies 


提供 了 cookies 方法， 本 质 是 request.cookie_jar 


Implicit Rend 


默认 泻 染 模板 。 
default render 


method for action 


我 们 在 Controller#action € > 2A render 模板 或 返回 数据 时 ... 就 会 用 到 它 。 


Instrumentation 

当 执 行 以 下 同名 方法 时 ， 会 发 送 消息 ， 及 有 时 间 记 录 ( 以 观察 性 能 等 指标 )。 
process_action 
redirect to 
render 


send data 
send file 


用 到 了 ActiveSupport::Notifications.instrument 和 Benchmark.ms 


Rendering 


对 一 般 的 render to body 和 render to string 稍微 做 处 理 。 


Rescue 
执行 到 具体 action 抛 异常 时 会 检测 是 否 需要 抛 异 常 ， 如 果 是 的 话 ， 抛 异常 。 
有 process action 同名 方法 。 


show detailed exceptions? (默认 是 false， 但 本 地 请 求 的 话 是 true)， 可 配置 
config.consider all requests local 


rescue with handler (封装 了 ActiveSupport::Rescuable 的 同名 方法 ) 


Ur-For 


url for 方法 的 组 成 部 分 。 


Basie Implicit Rend 


AF API 模式 时 ， 如 果 没 有 泻 染 或 重 定 向 ， 则 返回 204 (no content) » 


HE 


Metal 增强 模块 和 Middleware 的 区 别 

Middleware 是 Action Dispatch 实现 的 ， 而 Metal 增强 组 件 是 Action Controller 实 
现 的 。 

Middleware 是 在 请 求 进 入 Controller#action 之 前 ， 而 Metal 增强 组 件 是 在 请 求 进 
入 Controller#action 之 后 。 


Middleware 需要 的 环境 是 @env ， 作 用 的 是 app ; 而 Metal 增强 组 件 需 要 的 环 
境 是 Controller 和 action， 目 的 主要 是 对 请 求 做 处 理 ， 并 响应 。 


HE 


更 多 关于 Action Controller 


Controller 里 的 public 方 法 (也 就 是 action) 会 自动 对 应 Route 里 的 路 由 规则 。 当 请 求 
到 来 时 ，action 接受 请 求 并 处 理 ， 最 后 演 染 相应 视图 模板 (Get-and-show) 或 重 定向 
8| 5 — action(do-and-redirect). 


ne > 只 有 ApplicationController 直接 继承 于 ActionController::Base > X € 4942 #] 
器 继承 于 ApplicationController. 所 以 ， 如 果 你 想 在 所 有 controller 处 理 之 前 做 一 些 
什么 ， 你 可 以 把 它们 写 在 ApplicationController 里 。 


ActionController include 了 对 metal/ 目录 下 面 的 模块 ， 而 我 们 自 定 义 的 Controller 
又 继承 于 ActionController. 


自然 的 ， 它 们 的 ClassMethods 就 会 变 成 我 们 自 定 义 Controller 的 类 方法 ， 而 其 它 
方法 则 类 似 实 例 方 法 ， 可 运用 于 action. 


运行 action 时 的 魔法 


请 求 从 Action Dispatch 的 Routes 里 转发 过 来 ， 首 先 到 达 Metal 的 self.action 方 
法 ， 然 后 经 过 层 层 middleware 处 理 。 

再 然后 调用 Metal 的 dispatch 方法 (这 里 会 创建 Metal 的 实例 对 象 )， 调 用 
AbstractController::Base 的 process --> process action --> send action & send 完 


成 。 


Form Builder 


default form builder 


可 以 更 改 表单 构造 器 。 (表单 本 身 也 是 一 个 对 象 ， 通 过 Form Builder 添加 更 多 方 
ik) 


class AdminFormBuilder « ActionView::Helpers::FormBuilder 
def special field(name) 


class AdminController « ApplicationController 
default form builder AdminFormBuilder 
end 


调用 : 


<%= form for(Qinstance) do |builder| %> 
<%= builder.special field(:name) %> 
<% end %> 


Renderer 
让 泻 染 模板 需要 的 环境 变 得 更 容易 ， 不 必 强 制 依赖 于 具体 的 Controller#action. 
ApplicationController.renderer.render template: '... 


ApplicationController.render template: '... 


ApplicationController.renderer.new(method: 'post', https: true) 


原来 的 那 一 套 泻 染 流程 你 是 需要 依赖 于 某 个 Controller 这 大 环境 的 ， 但 有 的 场景 并 
不 需要 (比如 使 用 Action Cable 时 ) > 


有 方便 的 在 


`~ 


所 以 ， 现 在 拆 分 出 来 了 。 你 可 以 不 用 依赖 于 Controller > 3 4 fe 
Job ` Script 及 web sockets 里 调用 / 泻 染 模板 。 


` ua 


renderer 获取 演 染 器 实例 : 


ApplicationController.renderer 


它 所 依赖 的 环境 QGenv 1 Rack 一 样 ， 非 常 简单 : 


ApplicationController.renderer.defaults 


Railties Hel 


根据 配置 及 其 它 因素 ， 决 定 是 否 给 我 们 所 定义 的 Controller 加 载 所 有 可 用 的 
helpers. 


也 就 是 : 


klass.helper :all 


Note: 可 通过 config.action controller.include all helpers 进行 配置 只 加 载 
application helper 和 当前 Controller 所 对 应 的 x helper. 


Action Dispatch Routing RA 
提供 接口 ， 让 我 们 定义 应 用 相关 路 由 。 


先 说 说 Rack endpoint 


Rack endpoint 是 什么 ? 

需要 明确 Rack 是 一 个 协议 ， 符 合 这 个 协议 的 程序 统称 为 Rack application. Rack 
application 根据 表现 形式 、 调 用 方式 、 作 用 等 又 引申 出 几 个 概念 ， 其 中 就 包括 
Rack endpoint. 在 这 里 不 作 讨 论 和 区 分 ， 统 一 对 待 。 也 就 是 说 : 


Rack ~= Rack middleware ~= Rack endpoint ~= Rack application 


再 说 Routing 
一 切 路 由 规则 都 可 归结 为 : 映射 路 径 到 Rack endpoint. 


这 里 的 Rack endpoint 指 的 不 仅仅 是 Controller#action， 其 它 形式 的 入 口 也 可 以 ， 
例如 : Engine ` Sinatra 应 用 。 


Routing 主要 包含 两 部 分 : 


Mapper 这 部 分 ， 也 就 是 路 由 机 制 这 部 分 ， 这 是 我 们 接触 得 最 多 的 ， 它 包括 : 
Base ` Concerns ` HttpHelpers ` Resources ` Scoping. 


除了 Mapper 外 ， 用 到 的 还 有 : Redirection ` Polymorphic Routes ` Url For. 


Routing Pf # x4 ^ A x : 除 RouteSet ^ Routes Proxy 和 Journey 2} > routing E 
录 里 的 其 它 模 块 。 


Mapper 


TODO 


Base 
常用 方法 : 
match 
mount 


root 


match 方法 


这 里 的 match 只 是 个 同名 方法 ， 是 个 空 赤子 ， 具 体 实 现 要 看 Resources 里 的 


match . 


#3} > mount 和 root 本 质 上 ， 都 是 封装 和 扩展 match 方法 。 


mount 和 root 


match 


mount 方法 


挂 载 一 个 基于 Rack 的 应 用 到 我 们 的 程序 。 


match '/movies/search', => "movies#search" 
+ EG x [AS 


Ju. H 40 58% St IE A YY 
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match '/movies/search', => MoviesController.action(:search) 


Base 


4 这 是 一 个 Rack， 所 以 可 以 调用 call 方法 ， 传 递 env TRe 
MoviesController.action(:search).call(env) 


# 这 也 是 一 个 Rack. 
Proc.new { |env| 
[ 
200, 
{"Content-Type" => 'text/plain'}, 
["Hello, world" ] 


# 这 还 是 一 个 Rack. 
class ApiApp 
def call(env) 


[ 
200, 
{"Content-Type" => 'text/plain'}, 
["Hello, world" ] 
l 
end 


4 替换 Rack 
match '/movies/search', => proc ( |env| 


[ 
200, 


{"Content-Type" => 'text/pla 
am E 
["Hello, world"] 


# 替换 Rack 
match '/movies/search', -» ApiApp 
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# ht 
scope '/api' do 

match '(*path)', => ApiApp 
end 


# 加 上 语法 糖 ， 等 价 

mount ApiApp, :at => '/api' 
BR 

mount ApiApp => "api" 


因为 mount 实现 基于 match ， 可 以 使 用 相同 的 可 选 参 数 。 例 如 : 


mount(SomeRackApp => "some route", as: "exciting") 


现在 ， 你 可 以 通过 exciting path A exciting url 访问 到 刚才 挂 载 的 应 
用 o 


使 用 mount 代替 match 还 有 一 个 细节 不 同 ， 在 被 挂 载 的 Rack endpoint £ > I 
射 路 由 时 我 们 不 必 加 前 组。 举例 : 


不 是 : 


require 'sinatra' 

class ApiApp « Sinatra::Base 
get '/api' do 
end 


get "/api/endpoint" do 
end 


post "/api/endpoint" do 
end 
end 


D 
D 


a 


a 
o 
(OD 


require 'sinatra' 


class ApiApp « Sinatra::Base 


get '/' do 
end 


get "/endpoint" do 
end 


post "/endpoint" do 


end 
end 


root 方法 


实现 : 


def root(options = {}) 


match '/', { :as => :root, 


end 


AA root 实现 基于 match 


建议 你 把 root 放 在 config/routes.rb 
规则 是 从 上 至 下 生成 的 ， 会 优先 匹配 。 


:get }.merge! (options) 


， 可 以 使 用 相同 的 可 选 参数 。 


的 开头 部 分 ， 因 为 Rails 的 匹配 
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Http Helpers 
match 方法 的 语法 糖 。 


对 应 HTTP 请 求 里 的 : 


delete 
get 
patch 
post 
put 


FH: 


delete + get + patch + post + put 


使 用 上 : 


i 


# 注意 via 参数 


match 'photos/:id' => 'photos#show', via: 


# 对 应 着 
get 'photos/:id' => 'photos#show' 


:get 


Scoping 


scope 


当 几 个 路 由 规则 的 可 选 参数 (部 分 ) 都 一 样 的 时 候 ， 可 以 用 scope 把 它们 包 住 ， 避 


KER 


scope 并 不 会 


添加 路 由 ， 但 它 会 设置 @scope 的 值 ， 从 而 影响 如 何 生 成 路 由 。 


def scope(*args) 


@scope.options.each do |option| 


end 


@scope = 

yield 

self 
ensure 

@scope 
end 


@scope.new scope 


@scope. parent 


J > @scope Æ Scope 的 实例 对 象 。 


以 下 几 个 方法 ， 直 接 封 装 于 它 : 


方法 
namespace 


controller 


constraints 


defaults 


解释 
基于 scope， 只 是 设置 了 :module => path 
本 质 是 设置 了 scope 的 :path、:module 和 :as 参数 
基于 scope， 只 是 设置 了 :controller => controller 
和 普通 写法 差不多 ， 只 是 把 单行 改 为 了 多 行 的 形式 
基于 scope， 只 是 设置 了 :constraints 
传递 的 是 限制 条 件 ， 符 合 条 件 的 请 求 才 会 进入 里 面 的 路 由 ， 进 行 
下 一 步 操作 。 


基于 scope， 只 是 设置 了 :defaults 
作用 是 设置 默认 值 


SCOPE OPTIONS - [:path, :shallow path, :as, :shallow prefix, :mo 
dule, 
:controller, :action, :path names, :constraints 


:shallow, :blocks, :defaults, :options] 


controller 和 constraints 仅 做 约束 条 件 ， 不 影响 路 由 的 ' 一 个 萝卜 ， 一 个 
坑 ' 的 特性 。 其 它 几 个 方法 ， 看 情况 有 时 会 影响 。 


使 用 举例 : 


scope module: "admin" do 


resources :posts 
end 


resources :posts, module: "admin" 


可 将 "/posts" 路 由 到 Admin::PostsController 


scope "/admin" do 
resources :posts 
end 


resources :posts, path: "/admin/posts" 


可 将 "ladmin/posts" 路 由 到 PostsController 


scope 


一 、 不 使 用 scope 


resources :jjs 


默认 对 应 : 


jjs GET /jjs(.:format) 
POST  /jjs(.:format) 


new jj GET /jjs/new(.:format) 

edit jj GET /jjs/:id/edit(.:format) 
jj GET /jjs/:id(.:format) 
PATCH /jjs/:id(.:format) 


e 
PUT /jjs/:id(.:format) 
e 
DELETE /jjs/:id(.:format) 
oy 


二 、 使 用 scope， 但 不 传递 参数 


scope "/admin" do 
resources :iis 
end 


默认 对 应 : 


jjs#index 
jjs#creat 
jjs#new 
jjs#edit 
jjs#show 
jjs#updat 


jjs#updat 


jjs#destr 


iis 
e 
new ii 
edit ii 
ii 
e 
e 
oy 


可 以 看 出 ， 只 影 


GET 
POST 


GET 
GET 
GET 
PATCH 


PUT 


/admin/iis(.:format) 
/admin/iis(.:format) 


/admin/iis/new(.:format) 
/admin/iis/:id/edit(.:format) 
/admin/iis/:id(.:format) 
/admin/iis/:id(.:format) 


/admin/iis/:id(.:format) 


DELETE /admin/iis/:id(.:format) 


响 最 外 面 的 网 址 。 


三 、 使 用 Scope， 并 传递 参数 


iis#index 
iis#creat 
iis#new 
iisZedit 
iis#show 
iis#updat 


iis#updat 


iis#destr 


接受 参数 : path ` constraints ^ shallow path ` shallow prefix ` defaults ` as ^ 


module ` controller 4 ° 


3 个 很 重要 的 参数 之 一 


helper 


Scope as: "admin" 


resources 
end 


影响 中 间 层 


:ffs 


do 


admin ffs GET /ffs(.:format) ffs#ind 


ex 
POST /ffs(.: format ) ffs#cre 
ate 
new_admin_ff GET /ffs/new(.:format) ffs#new 
edit_admin_ff GET /ffs/:id/edit(.:format) ffs#edi 
t 
admin_ff GET /ffs/:id(.:format) ffs#sho 
w 
PATCH /ffs/:id(.:format) ffs#upd 
ate 
PUT /ffs/:id(.:format) ffs#upd 
ate 
DELETE /ffs/:id(.:format) ffs#des 
troy 


2) :path 参数 
3 个 很 重要 的 参数 之 一 
scope path: "/admin" do 
resources :ggs 
end 


/admin/ggs(.:format) 
/admin/ggs(.:format) 


/admin/ggs/new(.: format ) 
/admin/ggs/:id/edit(.:format) 
/admin/ggs/:id(.:format) 
/admin/ggs/:id(.:format) 


/admin/ggs/:id(.:format) 


DELETE /admin/ggs/:id(.:format) 


ggs GET 
POST 
e 
new_gg GET 
edit_gg GET 
gg GET 
PATCH 
e 
PUT 
e 
oy 


3) :module 参数 


3 个 很 重要 的 参数 之 一 


e 


AWARE RI Controller#action 


scope module: "admin" do 


resources :hhs 
end 


ggs#index 
ggs#creat 


ggs#new 
ggs#edit 
ggs#show 
ggs#updat 


ggs#updat 


ggs#destr 


hhs GET — /hhs(. 


Zindex 


POST  /hhs(. 


Zcreate 


: format) 


: format) 


new_hh GET /hhs/new(.:format) 


#new 


edit_hh GET /hhs/:id/edit(.:format) 


#edit 
hh GET /hhs/: 

#show 

PATCH /hhs/: 
#update 

PUT /hhs/: 
#update 

DELETE /hhs/: 
#destroy 


4) :path ` :as 和 :module 参数 


scope path: ":admin", as: 
resources :dds 
end 
等 价 于 


namespace :admin 


id(.:format) 


id(.:format) 


id(.:format) 


id(.:format) 


"admin", module: 


'admin 


do 


admin/hhs 


admin/hhs 


admin/hhs 


admin/hhs 


admin/hhs 


admin/hhs 


admin/hhs 


admin/hhs 


admin dds GET 
ds#index 
POST 
ds#create 
new_admin_dd GET 
ds#new 
edit_admin_dd GET 
ds#edit 
admin_dd GET 


/admin/dds(.:format ) 


/admin/dds(.:format ) 


/admin/dds/new(.: format) 


/admin/dds/:id/edit(.:format) 


/admin/dds/:id(.:format) 


/admin/dds/:id(.:format) 


/admin/dds/:id(.:format) 


DELETE /admin/dds/:id(.:format) 


ds#show 

PATCH 
ds#update 

PUT 
ds#update 
ds#destroy 


5) :defaults 参数 


对 应 着 defaults 方法 。( 它 是 通用 的 ， 类 型 为 Hash.) 


6) :constraints 参数 
对 应 着 constraints 方法 。 
7) :controller 参数 


对 应 着 controller 方法 。 


admin/d 


admin/d 


admin/d 


admin/d 


admin/d 


admin/d 


admin/d 


admin/d 


namespace 


namespace :admin do 
resources :posts 


end 
默认 对 应 : 
# 中 间 层 helper 方法 # 最 外 层 网 址 # 最 里 层 C 
ontroller#action 
admin_posts GET /admin/posts(.:format ) admin/ 
posts#index 
admin_posts POST /admin/posts(.:format ) admin/ 
posts#create 
new_admin_post GET /admin/posts/new(.:format) admin/ 
posts#new 
edit_admin_post GET /admin/posts/:id/edit(.:format) admin/ 
posts#edit 
admin_post GET /admin/posts/:id(.:format ) admin/ 
posts#show 
admin post PATCH/PUT /admin/posts/:id(.:format) admin/ 
posts#update 
admin_post DELETE /admin/posts/:id(.:format) admin/ 


posts#destroy 


1) 使 用 :path 更 改 最 外 层 网 址 : 


# 使 用 /sekret/posts 而 不 是 /admin/posts 

namespace :admin, path: "sekret" do 
resources :posts 

end 


2) 使 用 :module 更 改 最 里 层 Controller#action : 


4 使 用 Sekret::PostsController 而 不 是 Admin::PostsController 
namespace :admin, module: "sekret" do 

resources :posts 
end 


3) 使 用 :as 更 改 中 间 层 helper 方法 : 


4 使 用 sekret posts path 而 不 是 admin posts path 
namespace :admin, as: "sekret" do 

resources :posts 
end 


4) 此 外 : 


namespace "admin" do 
resources :kks 
end 


scope module: "admin", path: "/admin", as: "admin" do 
resources :kks 
end 


Concerns 


重复 使 用 已 经 定义 的 路 由 ， 避 免 config/routes.rb 里 出 现 重复 代码 ， 和 生成 路 
由 规则 没有 直接 联系 。 


方法 解释 
concern 定义 (一 次 只 能 定义 一 个 ) 
用 


concerns 调用 (一 次 可 调 


举例 (使 用 concern & concerns 之 前 ) : 


AppName::Application.routes.draw do 
resources :messages do 
resources :comments 
resources :categories 
resources :tags 
end 


resources :posts do 
resources :comments 
resources :categories 
resources :tags 

end 


end 


举例 (使 用 concern & concerns 之 后 ) : 


AppName::Application.routes.draw do 
concern :sociable do 
resources :comments 
resources :categories 
resources :tags 
end 


resources :messages do 
concerns :sociable 
end 


resources :posts do 
concerns :sociable 
end 


end 


concern :commentable do 
resources :comments 
end 


concern :image attachable do 
resources :images, only: :index 
end 





concerns 可 以 concern 


resources :messages, concerns: [:commentable, :image attachable] 
namespace :posts do 


concerns :commentable 
end 


一 些 疑 问 ? 


即使 是 去 除 重 复 代 码 ， 也 还 有 其 它 方法 实现 。 如 : 


AppName: :Application.routes.draw do 
def add_posts 
resources :posts, :only => [:create, :destroy] 
end 


resources :events do 
add_posts 
end 
end 


有 必要 使 用 DSL 5? 


在 讨论 里 dhh 回答 了 此 问题 。 


Resources 
常用 方法 : 
方法 解释 
resource 我 们 的 资源 不 需要 集合 操作 的 时 候 可 以 使 用 


resources 我 们 的 资源 需要 集合 操作 的 时 候 可 以 使 用 ， 本 方法 最 常用 
match 生成 路 由 规则 ， 并 添加 到 (set 里 


resource 
单个 资源 。 


调用 了 collection fr new， 以 及 set member mappings for resource 完成 所 有 。 


resource 


| 
V 


collection 和 new 和 member 


| 
V 


scope 


在 这 里 : colleciton 完成 create ; new 完成 new ; member 完成 edit ^ 
show ` update 和 destroy. 


resources 


调用 了 collection fr new > AA set member mappings for resource 完成 所 有 。 


resources 


| 
V 


collection 和 new 和 member 


| 
V 


scope 


在 这 里 : colleciton ÆA index 和 create : new 完成 new ; member 完成 
edit ` show ` update 和 destroy. 


match 


匹配 url 到 一 个 或 多 个 路 由 。 所 有 符号 ， 都 会 对 应 着 url 里 的 参数 ， 可 用 params 
获取 : 


# 对 应 着 params 里 的 :controller, :action 和 :id 
match ':controller/:action/:id' 


预 留 了 两 个 符号 ， controller 对 应 着 Controller ， :action 对 应 着 action. 也 
可 以 接受 模式 匹配 做 为 参数 : 


# 路 由 
match 'songs/*category/:title', to: 'songs#show' 


# URL 
'songs/rock/classic/stairway-to-heaven' 


# 对 应 : 
params[:category] = 'rock/classic' 
params[:title] = 'stairway-to-heaven' 


为 了 能 够 模式 匹配 ， 你 需要 分 配 一 个 名 字 给 它们 ， 如 果 没 有 分 配 ， 路 由 是 不 会 自动 
解析 的 。 


使 用 模式 匹配 时 ， 路 由 里 的 :action 和 :controller 应 该 以 Hash 的 形式 传递 过 来 比较 
好 。 例 如 : 


match 'photos/:id' => 'photos#show' 
match 'photos/:id', to: 'photos#show' 
match 'photos/:id', controller: 'photos', action: 'show' 


模式 匹配 ， 也 可 以 直接 指向 Rack application. 因为 它 实现 了 call FAR: 


match 'photos/:id', to: lambda {|hash| [200, (3, ["Coming soon"] 


1} 
match 'photos/:id', to: PhotoRackApp 


# YourController.action(:your action) 也 是 rack endpoint 
match 'photos/:id', to: PhotosController.action(:show) 


通过 HTTP 请 求 ， 容 易 带 来 安全 隐患 ， 所 以 你 可 以 使 用 HtttpHelpers[rdoc- 
ref:HttpHelpers]， 而 不 是 match 


match 


decomposed_match (还 分 几 种 情况 ) 


| 
V 


add route 


| 
V 


Qset.add route 


He: 
其 它 方 法 : 


nested 和 root 


scope 


namespace 


| 
V 


super (FF Scoping 里 的 namespace) 


scope 


resources_path_names 


shallow 
shallow? 


using_match_shorthand? 


protected 方法 : 


set member mappings for resource 


with exclusive scope 


with scope level 


set member mappings for resource 我 们 路 由 里 的 edit ^ show ` update 和 


destroy 由 它 完 成 。 


iR: 


VALID ON OPTIONS 
RESOURCE OPTIONS - 
ram, :concerns] 


[ : new, 
[:as, 


:collection, 
controller, 


: member ] 


: path, 


: only, 


: except, 


:pa 


Qscope 是 其 实例 对 象 。 


module ActionDispatch 
module Routing 
class Mapper 
def initialize(set) 
Qset = set 
@scope = Scope.new(( :path names => Qset.resources path 
names }) 
@concerns = {} 
@nesting = [] 
end 
end 
end 
end 


标准 化 路 由 规则 。 


match 会 调用 add_route， 进 而 (Qset.add route 完成 添加 路 由 规则 。 但 在 
@set.add_route 之 前 ， 要 先 把 路 由 规则 标准 化 。 


module ActionDispatch 
module Routing 
class Mapper 
module Resources 
# 


def match 


end 


def add route(action, options) 
path - path for action(action, options.delete(:path)) 


as = if !options.fetch(:as, true) 
options.delete(:as) 
else 
name for action(options.delete(:as), action) 
end 


mapping = Mapping.build(@scope, Qset, URI.parser.escap 
e(path), as, options) 

app, conditions, requirements, defaults, as, anchor - 
mapping.to route 


Qset.add route(app, conditions, requirements, defaults 
, as, anchor) 
end 
end 
end 
end 
end 


Constraints 


标准 化 路 由 规则 这 个 过 程 中 ， 涉 及 到 的 一 个 对 象 。 


module ActionDispatch 
module Routing 
class Mapper 
class Mapping 
def to route 
[ app(Qblocks), conditions, requirements, defaults, as 
, anchor ] 
end 


private 
def app(blocks) 
if to.respond to?(:call) 
Constraints.new(to, blocks, false) 
elsif blocks.any? 
Constraints.new(dispatcher(defaults), blocks, true) 
else 
dispatcher (defaults) 
end 
end 
end 
end 
end 
end 


Endpoint 的 子 类 之 一 ， 它 是 endpoint. 


Redirection 


路 由 里 的 redirect 方法 。 
redirect(*args, &block) 


在 routes.rb 里 配置 重 定 向 ， 将 发 向 某 路 径 的 请 求 ， 重 定向 到 另 一 路 径 : 
get "/stories" -» redirect("/posts") 
你 也 可 以 动态 的 重 定向 到 新 的 路 径 : 


get 'docs/:article', to: redirect('/wiki/%{article}') 


这 里 的 重 定向 ， 在 路 由 里 完成 ， 不 经 过 Action Controller 等 处 理 。 
并 且 ， 在 浏览 器 里 会 看 到 url 的 改变 。 


相关 类 有 : OptionRedirect、PathRedirect 及 Redirect. 根据 不 同 的 参数 情况 ， 会 对 
应 的 使 用 它们 做 处 理 。 在 这 里 我 们 只 关心 结果 ， 不 必 太 在 意 细 节 。 


match 和 scope 方法 - 重 中 之 重 


从 前 面 各 章节 ， 可 归纳 出 路 由 规则 里 ，match 和 scope 两 方法 是 重 中 之 重 。 
其 它 方 法 ， 都 在 在 这 两 方法 的 基础 上 ， 做 封装 、 语 法 糖 、 去 重复 代码 等 。 
match 是 生成 路 由 规则 ， scope 是 影响 如 何 生成 路 由 规则 。 


和 match 有 关 的 有 : get, post, delete, put +, 只 有 通过 它们 才能 添加 路 由 规则 ; 
fe scope 有 关 的 有 : namescope, collection, member, resource, resouces A 
套路 由 时 自动 完成 的 nested 等 。 它 们 主要 工作 是 调用 上 面 的 match 相关 方法 ， 并 
影响 生成 路 由 规则 。 


完成 路 由 规则 整个 过 程 中 ，match 和 scope 缺 一 不 可 。 


路 由 常用 方法 汇总 


下 面 方法 都 可 以 看 做 是 Mapper 的 实例 方法 ， 如 果 我 们 想 要 定制 自己 的 方法 ， 参 
考 它 们 即 可 。 


基本 : 
root 
mount 


match 


Http 方法 : 


get 
post 
patch 
put 
delete 


重 定向 : 


redirect 


作用 域 : 


Scope 
controller 
namespace 
constraints 
defaults 


关联 : 


concern 
concerns 


resource 
resources 
collection 
member 


常用 gem ‘devise’ 就 是 通过 给 Mapper 增加 实例 方法 的 方式 ， 在 路 由 里 为 我 们 提 
供 了 devise for 和 devise scope 方法 。 


x 


/一 > 


7. 65 


TODO 


Polymorphic Routes 
多 坊 路 由 辅助 方法 。 
实例 方法 


polymorphic url 
polymorphic path 


. 不 仅仅 是 多 态 关 联 里 的 ' 多 态 ' 

.可 根据 参数 (record 对 象 )， 自 动 计算 生成 url 
.有 几 个 常用 方法 是 基于 它 实 现 的 

不 用 指定 具体 的 路 由 helper 方法 
RRA AK FLARE 
.同样 依赖 于 路 由 系统 

. 使 用 它 会 使 得 复杂 度 提高 ， 难 以 理解 ， 所 以 不 要 滥用 


So Ron 一 


使 用 之 前 的 做 法 : 


# 在 这 里 parent TA% post X news 
if Post --- parent 

post comments path(parent) 
elsif News --- parent 

news comments path(parent) 
end 


使 用 之 后 : 


Polymorphic Routes 


# 使 用 post url(post) 
polymorphic url(post) 
osts/1" 


polymorphic url([blog, post]) # => "http://example. 


logs/1/posts/1" 


polymorphic url([:admin, blog, post]) # => "http://example. 


dmin/blogs/1/posts/1" 


polymorphic url([user, :blog, post]) # => "http://example. 


sers/1/blog/posts/1" 
polymorphic url(Comment) 
omment s " 


# => "http://example. 


# => "http://example. 


Note : 比较 常用 的 方式 是 以 数组 的 形式 传递 参数 。 


当然 ， 多 态 关联 也 可 用 : 


class Post < ActiveRecord::Base 


has many :comments 
end 


class News « ActiveRecord::Base 


has many :comments 
end 


class Comment « ActiveRecord::Base 


belongs to :commentable, 
end 


:polymorphic -» true 


com/p 


com/b 


com/a 


com/u 


com/c 


polymorphic path([parent, Comment]) 
4 "/posts/1/comments" 
4 或 


# "news/1/comments" 


polymorphic_url(parent) 
# "http://example.com/posts/1/comments" 
# 


# "http://example.com/news/1/comments" 


其 它 

new polymorphic path(Post) # "/posts/new" 

new polymorphic url(Post) # "http://example.com/posts/new" 
edit polymorphic path(post) # "/posts/1/edit" 

edit polymorphic url(post) # "http://example.com/posts/1/edit" 


‘action 以 及 其 它 参 数 
举例 : 
# 使 用 :aciton 可 选 参 数 


polymorphic path([Quser, Document], :action => 'filter') 
# => "/users/:user id/documents/filter" 


4 使 用 :aciton 可 选 参数 和 其 它 参 数 

polymorphic path([Quser, Document], :action => 'filter', :sort o 
rder -» 'this-order') 

4 => "/users/:user id/documents/filter?sort order-this-order" 


£j url for 的 区 别 


url for 比较 死板 ， 从 它 接受 的 参数 就 知道 了 。 它 不 能 接受 record 对 象 + 可 选 参数 
的 形式 。 


url for 不 能 直接 指定 host, FLEA er ， 它 只 有 调用 的 份 。 如 果 你 为 了 
一 个 url for 而 更 改 这 个 host 其 它 方法 或 其 它 url for 会 不 会 受 影响 ? 


其 它 方法 


除 上 述 外 ， 还 有 方法 (元 编程 生成 ，API 里 查看 不 到 ) : 


# 封装 polymorphic_url 而 来 

new MUS Tic url 

edit polymorphic url 
polymorphic path 而 来 

new Mol TOS path 

edit polymorphic path 


它们 封装 polymorphic url 3 polymorphic path 而 来 ， 所 以 特点 和 使 用 类 似 。 它们 
是 元 编程 定义 的 ， 所 以 API 里 看 不 到 。 


Helper Method Builder 


以 字符 串 拼 接 为 手段 ， 得 到 具体 的 路 由 helper 方法 (不 能 直接 得 到 网 址 1! )。 后 续 ， 
可 以 再 通过 路 由 helper ， 得 到 网 址 。 


:action - 其 实 是 生成 的 方法 所 带 的 前 级 ， 默 认 是 没有 的 。Rails 使 用 了 前 组 :new 和 
:edit 


routing. type - 生成 :path 还 是 :url, 默认 是 :Url. 


ActionDispatch: :Routing: :PolymorphicRoutes: :HelperMethodBuilder. 
plural 'edit', ‘url’ 


when Array 

builder.handle list record # 拆 分 处 理 ， 方 式 雷同 
when String, Symbol 

builder.handle string record # 
when Class 

builder.handle class record # 4*5 ^» ZAWA 
else 

builder.handle model record 


现在 可 以 看 到 Action View fe Action Dispatch 里 的 url for 方法 , 以 及 Action 
Dispatch 里 的 Polymorphic Routes 相关 方法 都 封装 了 它 ， 在 某 些 参数 情况 下 会 调 
用 到 它 。 其 它 地 方 ， 没 有 使 用 。 


原来 这 个 模块 是 在 Action Controller T 49 > & 7 4% 3] ActionDispatch::Routing. 


我 们 是 可 以 直接 使 用 这 几 个 方法 的 。 


Url For 


路 由 里 的 url for 方法 。 


和 ActionView::RoutingUrlFor 原理 一 样 ， 封 装 了 Helper Method Builder. (极端 情况 
下 才 调 用 到 ) 


使 用 举例 : 


url for controller: 'tasks', action: 'testing', host: 'example.o 
rg', port: '8080' 
4 => 'http://example.org:8080/tasks/testing' 


url for controller: 'tasks', action: 'testing', host: 'example.o 
rg', 

anchor: 'ok', only path: true 
# => '/tasks/testing#ok' 


url_for controller: 'tasks', action: 'testing', trailing_slash: 
true 
# => 'http://example.org/tasks/testing/' 


url for controller: 'tasks', action: 'testing', host: 'example.o 
rg’, number: "33" 
# => 'http://example.org/tasks/testing?number=33' 


url for controller: 'tasks', action: 'testing', host: 'example.o 
rg', 

script name: "/myapp" 
# => 'http://example.org/myapp/tasks/testing' 


url for controller: 'tasks', action: 'testing', host: 'example.o 
rg', 

script name: "/myapp", only path: true 
# => '/myapp/tasks/testing' 


可 选 参 数 的 类 型 可 以 是 : nil ^ Hash ` String ` Symbol ` Array ` Class 等 ， 根 据 不 
同 参 数 ， 可 能 会 用 到 【Polymorphic Routes】Helper Method Builder 里 的 东西 。 


Url For 
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Routing 概述 : (EX ^ BHR. RA 


描述 


1. 
.既然 维护 着 一 张 路 由 表 ， 如 何 向 表 里 添加 规则 ? 


w N 


DSL --> Mapper(Base, Concerns, HttpHelpers, Resources, Scoping) 


外 部 的 url 是 如 何 识 别 并 处 理 的 ?3 先 预 处 理 ， 然 后 对 照 路 由 表 ， 然 后 转发 给 
Controller#action， 再 接 下 来 就 是 我 们 熟悉 的 东西 了 。 


. 路 由 分 类 具名 路 由 和 匿名 路 由 ， 内 部 可 以 调用 具名 路 由 (不 调用 ， 它 就 没 意 义 


了 )。 那 么 这 些 方法 在 哪 定 义 的 ? 
. Rails 引入 了 engine 的 概念 ， 涉 及 到 engine 的 路 由 表 是 如 何 工作 的 ? 注意 上 
面 描述 里 的 动词 


1) 里 对 应 着 mapper.rb 文件 ， 及 里 面 的 各 个 子 模块 。 


2) 由 add route 完成 ， 涉 及 一 大 堆 的 东西 。 


3) 里 的 转发 给 Controller#action 这 部 


， 由 Dispatcher 完成 。 通 过 


A 
7 
controller.action(action).call(env) * &] £444) Controller & action -- 常见 的 rack 用 


法 。 


4) 里 的 定义 方法 ， 由 Named Route Collection 完成 。 它 还 代表 了 具名 路 由 。 


def define url helper(route, name, options) 
helper - UrlHelper.create(route, options.dup) 


Qmodule.remove possible method name 
Qmodule.module eval do 
define method(name) do |*args| 
helper.call self, args 
end 
end 


helpers «« name 
end 


def define named route methods(name, route) 
define url helper route, :"#{name}_path", 
route.defaults.merge(:use route -» name, :only path -» true) 
define url helper route, :"Zí(name) url", 
route.defaults.merge(:use route => name, :only path => false 


end 


4) 内 部 调用 并 不 一 定 总 是 通过 具体 路 由 进行 调用 ， 例 如 : 有 时 候 我 们 会 使 用 
link to @record ... 这 种 情况 ， 极 端 情况 下 会 由 路 由 这 边 生成 url， 由 Generator 完 
成 o 


5) 涉及 engine 的 路 由 部 分 ， 由 Mounted Helpers 完成 。 
Journey 就 是 个 打杂 的 ， 其 它 看 得 见 和 看 不 见 的 功能 由 它 负 责 。 
路 由 的 生成 、 存 储 、 识 别 


1) 路 由 对 象 的 定义 和 调用 方式 : 


HE 
module Rails 
class Engine « Railtie 
def routes 
@routes ||= ActionDispatch::Routing::RouteSet.new 
@routes.append(&Proc.new) if block given? # 调用 时 ， 也 可 以 追 
加 路 由 规则 
Qroutes 
end 
end 
end 


# 调用 方式 


Rails.application.routes 
Rails.application.routes { ... } 


2) 调用 路 由 对 象 ， 生 成 路 由 规则 : 


Rails.application.routes.draw do 
# ... block A 
end 


3) 生成 路 由 规则 ， 本 质 是 对 block 内 容 的 求 值 : 


def draw(&block) 
# l2. 
eval block(block) 


4) 怎么 求 值 呢 ?借助 了 Mapper 的 实例 对 象 : 


def eval block(block) 

Ho... 

mapper - Mapper.new(self) 

T ke 

mapper.instance exec(&block) 
end 


5) Mapper 的 实例 对 象 有 什么 内 容 ? 


module ActionDispatch 
module Routing 
class Mapper 
# 这 里 set = Rails.application.routes 
def initialize(set) 
Qset = set 
@scope = Scope.new(( :path names => Qset.resources path 
names }) 
@concerns = {} 
@nesting = [] 
end 
end 
end 
end 


6) Mapper 实例 对 象 有 了 ， 下 一 步 就 是 执行 instance exec. 也 就 是 运行 block 里 的 
各 个 方法 。 


7) block 里 的 各 个 方法 ， 是 在 Mapper 下 面 的 各 个 模块 里 定义 的 : 


module ActionDispatch 
module Routing 
class Mapper 
He uon 


class Constraints « Endpoint 
Ho... 
end 


Routing 概述 : 生成 、 存 储 、 识 别 


class Mapping 
TT 
end 


class Scope 
Ho. 
end 


Ko... TA EM 


module Base 
WW uar 
end 


module HttpHelpers 
To 
end 


module Redirection 
1 CES 
end 


module Scoping 
Tus 
end 


module Concerns 
S? an 
end 


module Resources 
2 NS 
end 


include Base 
include HttpHelpers 
include Redirection 
include Scoping 
include Concerns 
include Resources 
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end 
end 
end 


在 这 里 ， 不 同 的 路 由 规则 会 有 对 应 的 模块 进行 处 理 ， 具 体 可 以 在 对 应 的 各 个 章节 查 
看 。 


8) 附 : Mapper 的 ancestors 


ActionDispatch::Routing::Mapper.ancestors 
=> [ActionDispatch::Routing::Mapper, 


ActionDispatch: :Routing: :Mapper::Resources, 
ActionDispatch: :Routing: :Mapper::Concerns, 
ActionDispatch: :Routing: :Mapper: :Scoping, 
ActionDispatch: :Routing: :Redirection, 
ActionDispatch: :Routing: :Mapper::HttpHelpers, 
ActionDispatch: :Routing: :Mapper: :Base, 


一 步 步 分 析 从 请 求 到 响应 涉及 到 Rails 的 哪些 模块 


通过 本 章节 ， 你 可 以 比较 独立 的 使 用 Rails 的 各 个 模块 ， 有 利于 理解 Rails 源码 各 
个 模块 的 主要 工作 。 


纯 Rack 实现 


# config.ru 
require 'bundler/setup' 


run Proc.new {|env| 
if env["PATH_INFO"] == "/" 


[200, {"Content-Type" => "text/html", ["<h1>Hello World</h1>" 
1] 


else 


[404, ("Content-Type" => "text/html"}, ["<h1>Not Found</h1>"] 


end 


} 


4 az i 


引入 Action Dispatch & 2.42 3: 3I, Controller#actions 


一 步 步 分 析 从 请 求 到 响应 涉及 到 Rails 的 哪些 模块 


# config.ru 
require 'bundler/setup' 
require 'action dispatch' 


routes - ActionDispatch::Routing::RouteSet.new 

routes.draw do 
get '/' => 'mainpage#index' 
# 和 以 下 写法 效果 一 样 ， 但 ' 这 里 ' 要 把 它 定义 在 MainpageController 后 面 
# get '/' -» MainpageController.action("index") 


get '/page/:id' => 'mainpage#show' 
end 


class MainpageController 
def self.action(method) 
controller - self.new 
controller.method(method.to sym) 
end 


def index(env) 
[200, ("Content-Type" => "text/html"}, ["<h1>Front Page</h1>" 


]] 


end 


def show(env) 
[200, {"Content-Type" => "text/html"}, 
["<pre> Z(env['action dispatch.request.path parameters'][:id 
]} #</pre>"]] 
end 
end 


run routes 


| 
引入 Action Controller > 使 用 Metal 
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4 config.ru 

require 'bundler/setup' 
require 'action dispatch' 
require 'action controller' 


routes - ActionDispatch::Routing::RouteSet.new 
routes.draw do 

get '/' => 'mainpage#index' 

get '/page/:id' => 'mainpage#show' 
end 


class MainpageController < ActionController: :Metal 
def index 
self.response body = "<h1>Front Page</h1>" 
end 


def show 
self.status = 404 
self.response_body = 
"<pre>#{env[ 'action_dispatch.request.path_parameters'] [:id 
]}</pre>" 
end 
end 


run routes 
[E —wJE > gc 
注意 : 上 面 已 经 使 用 到 了 Action Dispatch 里 的 "各 个 Middleware 组 件 "， 但 并 没有 
使 用 到 Action Controller 里 的 "各 个 Metal 增强 组 件 " © 


引用 Metal 增强 模块 & Controller 里 纯 手工 打造 View È #78 X 
代码 





4 config.ru 

require 'bundler/setup' 
require 'action dispatch' 
require 'action controller' 


routes - ActionDispatch::Routing::RouteSet.new 
routes.draw do 

get '/' => 'mainpage#index' 

get '/page/:id' => 'mainpage#show' 
end 


class MainpageController < ActionController::Metal 
include AbstractController::Rendering 
include ActionController::Rendering 
include ActionController::ImplicitRender 


def index 
# self.response body = "<h1>Front Page</hi>" 
Qlocal var - 12345 

end 


def show 
self.status - 404 
self.response body - 
"<pre>#{env[ 'action_dispatch.request.path_parameters'] [:id 
]}</pre>" 
end 


def render_to_body(*args) 
template = ERB.new File.read("#{params[:action]}.html.erb") 
template.result(binding) 
end 
end 


run routes 


En 


NO 
NO 
IN 


# index.html.erb 


Number is: <%= Qlocal var 96» 


引进 Action View 


4 config.ru 

require 'bundler/setup' 
require 'action dispatch' 
require 'action controller ' 
require 'action view' 


routes - ActionDispatch::Routing::RouteSet.new 
routes.draw do 

get '/' => 'mainpage#index' 

get '/page/:id' => 'mainpage#show' 
end 


class MainpageController < ActionController: :Metal 
include AbstractController: :Rendering 
include ActionView: :Rendering 
include ActionController: :Rendering 
include ActionController::ImplicitRender 


prepend view path('app/views') 


def index 
Qlocal var = 12345 
end 


def show 
end 
end 


use ActionDispatch::DebugExceptions 
run routes 


Number is: <%= local var 96» 


# app/views/mainpage/show.html.erb 


Content is: <pre><%= env['action dispatch.request.path parameter 
s'][:id] %></pre> 


&| 36 > Routing ` Controller ` View 34 2 2) 4% » Model 我 们 可 以 直接 调用 ， 不 影 
响 这 里 的 整个 请 求 、 响 应 处 理 过 程 。 


直接 使 用 ActionController::Base 


前 面 提 到 过 ActionController:: Metal 相当 于 一 个 加 强 版 本 的 Rack， 功 能 非常 有 限 ， 
实际 开发 中 建议 使 用 继承 于 它 的 ActionController::Base. 


ye a lg. ^E BAG 5 27% Al : 4A a be 32 
一 步 步 分 析 从 请 求 到 响应 涉及 到 Rails 8 9p 


4 config.ru 

4 require 'bundler/setup' 

4 require 'action dispatch' 
4 require 'action view' 
require 'action controller' 


routes - ActionDispatch::Routing::RouteSet.new 


routes.draw do 

get '/' => 'mainpage#index' 

get '/page/:id' => 'mainpage#show' 
end 


class MainpageController < ActionController: :Base 


prepend_view_path('app/views/' ) 
def index 
@local_var = 12345 
end 
def show 
end 


end 


use ActionDispatch: :DebugExceptions 
run routes 


对 应 以 上 代码 ， 我 们 需要 创建 视图 文件 。 


# app/views/mainpage/index.html.erb 


和 


# app/views/mainpage/show.html.erb 
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上 述 代码 : 

没有 使 用 Action Mailer > Active Job, Active Model, Active Record 等 ; 
使 用 但 没 感受 到 Abstract Controller * Active Support, Railties 等 ; 
没有 使 用 Engine 等 。 


上 面 代码 里 的 run 方法 由 应 用 服务 器 提供 ， 用 于 运行 一 个 Rack application. 
参考 


A Rails App in a Single File 


OUR ees 


endpoint 文件 下 的 内 容 : 


类 解释 


Mapper::Constraints ^ Redirect 和 RouteSet::Dispatcher 的 抽象 
Endpoint &° 
定义 了 dispatcher? ` redirect? ` matches? 和 app 方法 。 


inspector 文件 下 的 内 容 : 


类 解释 
Route Wrapper 被 Routes Inspector 调用 。 


被 middleware Debug Exceptions 和 rake routes 调 


Routes Inspector He 


Html Table 
Formatter 


Console Formatter 格式 化 控制 台 里 的 路 由 信息 ， 给 人 阅读 的 。 


格式 化 HTML 里 的 路 由 信息 ， 给 人 阅读 的 。 


Action Dispatch Middleware 


Middleware - 在 路 由 转发 之 后 ，Controller#action 接收 之 前 ， 对 环境 和 应 用 进行 
处 理 。 


路 由 转发 (Dispatcher#dispatch) --> 中 间 地 带 (middleware) --> 控制 器 
(Controller#action) ° 


已 经 进入 Rails, 但 还 没 正 式 进 入 我 们 应 用 ， 这 时 候 需 要 做 一 些 事 。 


Web 服务 器 已 经 处 理 过 ， 转 发 过 来 了 。 做 一 些 什 么 事 呢 ?看 一 看 下 面 的 
middleware 都 提供 了 什么 功能 就 知道 了 。 


下 面 只 是 做 简介 ， 详 情 可 以 查看 API 说 明 ， 或 阅读 源 代码 。 


Middleware 


TODO 


Rack - Ruby Web server 接口 


用 Ruby 或 "Ruby 实现 的 Web "创建 的 应 用 ， 想 要 提供 nn 服务 ， 它 们 都 要 
fe Web 服务 器 打交道 。 而 这 程 是 非常 复杂 的 ， 为 了 简化 这 个 过 程 ， 我 们 可 以 
使 用 Rack. 


app 应 用 --» (Rack) --> 应 用 服务 器 --> Web 服 务 器 --> 外 部 世界 


Rack 提供 了 一 个 "与 Web 服 务 器 打交道 "最 精简 的 接口 ， 通 过 这 个 接口 ， 我 们 的 应 
用 很 轻松 的 就 能 提供 Web 服务 (接收 Web 请 青 求 ， 响 应 处 理 乡 告 果 )。 上 面 的 "应 用 服务 
器 "是 对 Rack 的 进一步 封装 。 


使 用 这 个 接口 的 条 件 是 : 传递 一 个 "程序 "( 你 没 看 错 ， 就 是 把 一 个 程序 当做 参数 ， 下 
文 以 app 代替 )。 并 且 这 个 app 需要 同时 满足 以 下 条 件 : 


e app. PTT. to? :call #=> true 

e app 创建 过 程 需要 以 运行 环境 做 为 参数 (类 型 为 Hash* FRY env 代替 运行 
环境 ) 

e app 需要 返回 一 个 数组 ， 数 组 包含 3 个 元 素 ， 依 次 是 : 


o HTTP status code 
o HTTP headers (类 型 为 Hash) 
o HTTP body data (类 型 能 接受 each 方法 即 可 ) 


最 小 的 Rack 


Proc.new { |env| 
[ 
200, 
{"Content-Type" => 'text/plain'}, 
["Hello, world" ] 


使 用 举例 


# my rack app.rb 
require 'rack' 


app = Proc.new do |env| 
['200', {'Content-Type' => 'text/html'}, ['A example rack app.' 
1] 


end 


Rack: :Handler::WEBrick.run app 
a aa 


你 也 可 以 使 用 rackup 命令 ， 节 省 点 时 间 和 力气 : 
4 config.ru 


run Proc.new { |env| ['200', {'Content-Type' => 'text/html'}, [' 
get rack\'d']] 3 

运行 : 

rackup config.ru 


: 
元 。 


再 举 个 例子 : 


可 以 封装 Rack， 得 到 我 们 自己 的 YourRack， 或 : 


Da, ) l^ \Ad bs us miar 1E Y 
Rack - Ruby Web server 4& 4 


Veo 
V VI TA 


class YourRack 
def initialize(app) 


@app = app 
end 


def initialize(app) 


@app = app 
end 


def call(env) 
@app.call(env) 
end 
end 


再 使 用 举例 


'rack/contrib' 可 以 自动 加 载 Rack 包含 的 所 有 组 件 ， 以 下 例子 可 用 rackup 


config.ru 运行 : 


require 'rack' 
require 'rack/contrib' 


use Rack::Profiler if ENV['RACK ENV'] == 'development' 


use Rack::ETag 
use Rack: :MailExceptions 


run theapp 


链接 


Rack: a Ruby Webserver Interface 
a modular Ruby webserver interface 
Contributed Rack Middleware and Utilities 


查看 项 目 用 了 哪些 Middleware 
命令 行 里 查看 ， 项 目 有 哪些 middleware: 


rails middleware 


如 下 : 


use 


use 
use 


use 


use 
use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


use 


run 


Rack: :Sendfile 


ActionDispatch: 
ActionDispatch: 


:Static 
:LoadInterlock 


ActiveSupport::Cache::Strategy: :LocalCache 


Rack: :Runtime 


Rack: :MethodOverride 


ActionDispatch: 


: RequestId 


Rails::Rack::Logger 


ActionDispatch: 


: ShowExceptions 


WebConsole::Middleware 


ActionDispatch: 
ActionDispatch: 
ActionDispatch: 
ActionDispatch: 


: DebugExceptions 
: RemoteIp 
: Reloader 
:Callbacks 


ActiveRecord: :Migration: :CheckPending 


: :Middleware 


ActiveRecord: :ConnectionAdapters: :ConnectionManagement 


ActiveRecord: :QueryCache 


ActionDispatch: 
ActionDispatch: 
ActionDispatch: 


Rack: :Head 


: Cookies 
:Session::CookieStore 
:Flash 


Rack: :ConditionalGet 


Rack: :ETag 


ActionView::Digestor::PerRequestDigestCacheExpiry 


AppName: :Application.routes 


控制 台 里 查看 ， 项 目 有 哪些 middleware: 


Rails.application.send :default middleware stack 


如 下 : 


Rack: :Sendfile, 


ActionDispatch::Static, 
ActionDispatch::LoadInterlock, 


Rack: :Runtime, 
Rack: :MethodOverride, 


ActionDispatch: :RequestId, 
Rails: :Rack::Logger, 


ActionDispatch: :ShowExceptions, 
ActionDispatch: :DebugExceptions, 
ActionDispatch: :Remotelp, 
ActionDispatch: :Reloader, 
ActionDispatch: :Callbacks, 
ActionDispatch: :Cookies, 
ActionDispatch: :Session::CookieStore, 
ActionDispatch::Flash, 


Rack: :Head, 
Rack: :ConditionalGet, 
Rack: :ETag 


Rails.application.send :middleware 


如 下 : 


Rack: : Sendfile, 


ActionDispatch::Static, 
ActionDispatch::LoadInterlock, 


ActiveSupport::Cache::Strategy: :LocalCache 


Rack: :Runtime, 
Rack: :MethodOverride, 


ActionDispatch: :RequestId, 
Rails: :Rack::Logger, 
ActionDispatch: :ShowExceptions, 
WebConsole: :Middleware, 
ActionDispatch: :DebugExceptions, 
ActionDispatch::RemoteIp, 
ActionDispatch: :Reloader, 


ActionDispatch: :Callbacks, 


ActiveRecord: :Migration: :CheckPending, 


: : Middleware, 


ActiveRecord::ConnectionAdapters::ConnectionManagement, 


ActiveRecord: :QueryCache, 


ActionDispatch: :Cookies, 
ActionDispatch: :Session: :CookieStore, 
ActionDispatch::Flash, 


Rack: :Head, 
Rack: :ConditionalGet, 
Rack: :ETag, 


ActionView::Digestor::PerRequestDigestCacheExpiry 


说 明 : 默认 添加 middleware 可 以 在 
Rails::Application::DefaultMiddlewareStack#build_stack 里 查看 ; 而 我 们 手动 添加 
的 middleware 通常 在 config/ 下 添加 。 执 行 middleware 由 
ActionController::Metal.action 完成 。 


在 上 面 例子 里 ， 除 默认 middleware 外 ， 我 们 还 额外 使 用 了 4 个 middleware. 在 实 
际 项 目 中 ， 你 应 该 可 以 看 到 比 这 多 得 多 的 middleware. 


另外 ， 从 应 用 的 日 常 报错 上 ， 也 能 看 出 应 用 所 使 用 的 middleware 及 其 顺序 ， 在 此 
就 不 贴 示例 了 。 


定制 Middleware 


middleware 本 质 就 是 Rack app， 只 十 简单 封装 了 一 下 。 
我 们 可 以 编写 自己 的 Middleware， 用 来 处 理 @app 和 env. 
举例 一 


放 在 app/middleware/ 目录 下 ， 按 照 middleware 写 。 然 后 在 config 里 use 就行 
了 ， 不 用 做 其 它 的 配置 。 


class Scrubber 
def initialize(app, options) 
@app = app 
@routes = options[:routes] 
end 


def call(env) 
scrub(env) 
@app.call(env) 
end 


private 
def scrub(env) 
return unless Qroutes.include?(env["PATH INFO"]) 
rack input - env["rack.input"].read 
params - Rack::Utils.parse query(rack input, "&") 
params["xml"] = Rack::Utils.unescape(params["xm1"]) 
env["rack.input"] - StringIO.new(Rack::Utils.build query(p 
arams)) 
rescue 
ensure 
env["rack.input"].rewind 
end 
end 


AS: 


# 注意 ， 这 里 直接 引用 相关 类 

config.middleware.insert before ActionController::ParamsParser, 
"Scrubber", 
:routes => [ "/examples/scrubbed" | 


举例 二 


放 在 lib/ 目录 下 ， 按 照 middleware 写 。 然 后 在 config € use 就行 了 ， 不 用 做 其 它 
的 配置 。 


class ResponseTimer 
def initialize(app, message = "Response Time") 
@app = app 
@message = message 
end 


def call(env) 
dup. call(env) 
end 


def _call(env) 
Qstart = Time.now 
Qstatus, @headers, @response = Qapp.call(env) 
@stop = Time.now 
[@status, @headers, self] 
end 


def each(&block) 
if @headers["Content-Type"].include? "text/html" 
block.call("«!-- #{@message}: #{@stop - Qstart) -->\n") 
end 


Qresponse.each(&block) 


end 
end 


AS: 


定制 Middleware 


# 注意 ， 这 里 以 字符 串 的 方式 引用 
config.middleware.use "ResponseTimer", "Load Time" 


参考 


Sanitizing POST params with custom Rack middleware 
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Middleware-Stack 
用 实例 变量 @middlewares 存储 我 们 项 目 要 使 用 的 middleware. 
提供 方法 : 

[] 

build 

delete 

each 

initialize copy 


insert & insert before 
insert after 


last 
size 
swap 
unshift 


use 


Note: i£ £e [Configuration Middleware Stack Proxy] 3t * 4 RAE si » 


各 个 Middleware 类 


TODO 


Static 
从 硬盘 直接 返回 静态 文件 的 内 容 。 


默认 这 些 静 态 文件 存放 在 public/ 目录 下 ， 如 果 找 不 到 文件 ， 或 者 移 除 此 
middleware， 则 处 理 方 式 和 普通 请 求 一 样 ， 由 路 由 决定 转发 到 哪 。 


SSL 


如 果 网 站 采用 了 HSTS(HTTP Strict Transport Security) 协议 ， 该 middleware 保证 
通过 浏览 器 访问 时 ， 始 终 连 接 到 该 网 站 的 HTTPS 加 密 版 本 (也 就 是 ， 访 问 被 强制 
https 了 )， 不 需要 用 户 手 动 在 URL 地 址 栏 中 输入 加 密 地 址 。 


实际 项 目 中 ， 如 果 用 不 到 HSTS(HTTP 严格 传输 安全 协议 )， 可 以 考虑 将 此 
middleware 移 除 。 


Show Exceptions 


程序 抛 异常 时 ， 用 什么 程序 来 处 理 。 


wa 


它 只 是 接口 ， 它 关心 的 是 用 什么 ， 而 不 是 如 何 处 理 。( 因 为 不 是 它 处 理 的 1 ) 对 内 调 
用 Exception Wrapper 对 外 调用 Public Exceptions. 


wrapper = ExceptionWrapper.new(env, exception) 


config.exceptions app || ActionDispatch::PublicExceptions.new(Ra 
ils.public path) 


response - Qexceptions app.call(env) 





Exception Wrapper 

更 友好 的 异常 消息 ， 包 括 可 读 性 ， 回 朔 等 。 

被 Show Exceptions 调用 。( 另 ， 它 其 实 不 是 middleware) 
ActionDispatch::ExceptionWrapper.rescue responses 


=> ("ActionController::RoutingError"-»:not found, 
"AbstractController::ActionNotFound"-»:not found, 
"ActionController::MethodNotAllowed"-»:method not allowed, 
"ActionController::NotlImplemented"-»:not implemented, 


"ActionController: :InvalidAuthenticityToken"=>:unprocessable_e 


ntity, 
"ActiveRecord: :RecordNotFound"=>:not_found, 
"ActiveRecord: :StaleObjectError"=>:conflict, 
"ActiveRecord: :RecordInvalid"=>:unprocessable_entity, 
"ActiveRecord: :RecordNotSaved"=>:unprocessable_entity} 


ActionDispatch::ExceptionWrapper.rescue templates 


=> ("ActionView::MissingTemplate"-»"missing template", 
"ActionController::RoutingError"-»"routing error", 
"AbstractController::ActionNotFound"-»"unknown action", 
"ActionView::Template::Error"-»"template error") 


Public Exceptions 


负责 ' 泻 染 ' 错 误 页 面 这 个 工作 。 黑 认 从 public/ 目录 中 寻找 对 应 的 异常 文件 ， 如 500 
NER a 


它 只 处 理 泻 染 相 关 逮 辑 ， 只 是 "定义 "， 至 于 要 不 要 使 用 它 做 为 默认 异常 处 理 ， 由 
Show Exceptions 和 Exception Wrapper 等 共同 决定 。 


定制 Public Exceptions 


默认 的 Public Exceptions ， 显 示 public/ 目录 下 的 错误 页 面 


config.exceptions app 可 以 配置 Show Excepting JaA% E] de fep Zh 3E. o Je : 


举例 一 


# config/environments/production.rb 
config.exceptions app = ErrorController.action(:handle) 


4 app/controllers/error controller.rb 
class ErrorController 
def handle 
flash.alert(t(".message")) 
redirect to :back 
end 
end 


4 config/application.rb 
config.exceptions app - self.routes 


4 config/routes.rb 

match '/404', via: :all, to: 'errors£znot found' 

match '/422', via: :all, to: 'errors£Zunprocessable entity' 
match '/500', via: :all, to: 'errors£Zserver error' 


# app/controllers/errors controller.rb 
class ErrorsController « ActionController 
layout 'error' 


def not found 
render status: :not found 
end 


def unprocessable entity 
render status: :unprocessable entity 
end 


def server error 
render status: :server error 
end 
end 


4 app/views 


errors/ 
not found.html.erb 
unprocessable entity.html.erb 
server error.html.erb 
layouts/ 
error.html.erb 


:: Base 


Debug Exceptions 
负责 在 开发 环境 下 ， 在 页 面 上 输出 日 志和 debug 信息 。 


有 Show Exceptions 的 性 质 ， 但 不 同 的 是 Show Exceptions 比较 通用 。 而 Debug 


Exceptions 用 于 本 地 开发 ， 因 为 此 时 我 们 希望 看 到 更 多 、 更 友好 的 错误 信息 。 


middleware/templates/ 目录 下 的 文件 ， 直 接 和 它 相 关 。 


Request Id 
使 用 现成 (请 求 里 面 有 的 话 )， 或 为 每 个 请 求生 成 唯一 的 X-Request-Id. 


可 以 在 防火 墙 、 负载 均衡 、Web 服 务 器 之 间 传 递 ， 可 用 于 跟踪 用 户 ， 方 便 日 志 处 
理 ; 或 查看 请 求 在 集群 中 哪 台 机 器 上 处 理 。 


Rails 里 可 通过 request.uuid 查看 ， 相 关 HTTP header 是 X-Request-Id 标 
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根据 经 验 ， 实 际 项 目 中 可 以 考虑 将 此 middleware 移 除 。 


Remote Ip 
HSA Pe IP 地 址 ， 可 用 于 防止 IP 伪造 等 。 
相关 HTTP header  X-Forwarded-For (XFF) 标识 。 


nom 这 一 字段 比较 容易 ， 对 于 一 般 的 攻击 者 而 言 ， 它 管用 ; 但 对 于 高 明 的 攻击 者 而 
， 可 以 考虑 将 此 middleware 移 除 。 


un 


Reloader 


保证 在 请 求 之 前 和 响应 之 后 做 某 事 。 这 里 重点 是 "保证 "， 具 体 是 什么 事 ， 怎 么 做 ， 
不 由 它 决定 。 


类 方法 : 
to_prepare 


to cleanup 


4-84 block. 


to prepare fRiEH@RARZA dure? 
j 它 给 的 block. 


to cleanup 保证 在 每 次 响应 之 后 ， 执 和 
实例 方法 (middleware 的 call 方法 会 调用 它们 ) : 
prepare! # 执行 to prepare 给 的 block. 


L 


cleanup! # 执行 to cleanup 给 的 block. 


类 方法 (作用 同上 ， 但 我 们 可 以 手动 调用 ) : 
prepare! 


cleanup! 


开发 环境 下 ， 我 们 会 经 常 更 改 代码 ， 但 我 们 又 希望 请 求 、 响 应 速度 加 快 。 此 时 ， 可 
以 使 用 此 middleware， 因 为 它 可 以 帮 有 我 们 达到 愿望 。 


Params Parser 
解析 ， 并 格式 化 请 求 过 来 的 参数 。 


包括 但 不 限于 ， 当 请 求 的 数据 格式 是 JSON 类 型 时 ， 进 行 转换 : 


data = ActiveSupport::JSON.decode(request.raw post) 
data = {:_json => data} unless data.is a?(Hash) 


Request::Utils.deep munge(data).with indifferent access 


注意 : 不 是 所 有 参数 ， 特 指 request.request parameters ， 也 就 是 POST 请 
求 发 过 来 的 参数 。 


Flash 


提供 对 flash 消息 的 创建 、 读 / 写 、 删 除 等 相关 操作 。 
有 FlashHash 和 FlashNow 两 个 类 。 


flash 是 FlashHash 的 实例 对 象 ; 
flash.now 是 FlashNow 的 实例 对 象 。 


[] 
Mi 


now 


alert 
alert- 


notice 
notice- 


empty? 
clear 
delete 
discard 


key? 
keys 


to hash 
each 
initialize copy 


keep 


使 用 上 就 能 感觉 得 出 flash 消息 兼 有 Hash 和 Enumerable 实例 对 象 的 部 分 特性 。 


至 于 如 何 使 用 ， 可 以 查看 【Flash 相关 使 用 】 章 节 。 


Cookies & ChainedCookieJars 


可 以 通过 ActionController#cookies 12/5 cookies 数据 。 


基本 的 写 (由 Cookies 提供 ): 


# 简单 的 cookie 数据 
We 


# 浏览 器 关闭 则 删除 
cookies[:user name] = "david" 


4 cookie 存储 字符 串 数据 ， 其 它 格 式 要 转化 。 
cookies[:lat lon] = JSON.generate([47.68, -122.37]) 


# 设置 cookie 数据 的 生命 周期 为 一 小 时 
cookies[:login] = ( value: "XJ-122", expires: 1.hour.from_now } 


S 


写 ( 由 ChainedCookieJars 提供 ) : 


a ^k 


# cookie #24 (M $lsecrets.secret key base)» Wik PRR -o 
# 可 以 使 用 cookies.signed[:name] 获取 这 签名 后 的 数据 
cookies.signed[:user id] = current user.id 


# 设置 一 个 "永久 " cookie» XE AML 20 年 。 
cookies.permanent[:login] = "XJ-122" 


# 你 可 以 链 式 调用 以 上 方法 


cookies.permanent.signed[:login] = "XJ-122" 

读 : 
cookies[:user name] 4 => "david" 
cookies.size dE 
JSON.parse(cookies[:lat lon]) # => [47.68, -122.37] 
cookies.signed[: login] # => "XJ-122" 


9 ER: 


cookies.delete :user name 


除 上 面 提 到 的 signed 和 permanent 7t > ChainedCookieJars 还 提供 方法 : 


# cookie 数据 加 密 ( 用 到 secrets.secret_key_base) AMT signed 方法 
# 可 以 使 用 cookies.encrypted[:discount] 获取 这 签名 后 的 数据 (已 经 自动 解 
客 ) 


in 


cookies.encrypted[:discount] = 45 


signed or encrypted 


Session 


主要 是 配置 Session 的 存储 方式 。 
C 


«3| 


it Cache Store && Cookie Store && Mem Cache Store 
得 最 多 ， 并 且 软 认 的 是 CookieStore. 


用 
可 以 在 config/initializers/session store.rb 配置 你 的 session 存储 方式 : 


Rails.application.config.session store :cookie store, key: ' you 


r app session' 


可 以 在 config/secrets.yml 配置 生成 session 4) # 4A: 


development: 
secret key base: 'secret key' 


( 密 钥 除 签 名 、 加 密 session 外 ， 还 有 其 它 用 途 ) 
运行 rake secret .会 生成 随机 字符 串 ， 你 可 以 使 用 它们 做 为 secret_key,. 


Note: 如 果 你 更 改 了 secret key 的话 ， 之 前 的 session 就 不 能 使 用 了 。 因 为 
secret key 还 有 其 它 用 途 ， 一 般 不 建议 更 改 。 


Callbacks 
可 以 在 某 个 middleware 执行 之 前 、 之 后 ， 执 行 一 些 回调 方法 。 


因为 我 们 middleware 本 身 就 是 链 式 调用 ， 一 个 个 执行 ， 所 以 这 里 的 回调 意义 不 
db a 


define callbacks :call 


任何 一 个 middleware (或 者 说 Rack) 很 重要 的 两 个 方法 : 


def initialize(app) 
@app = app 


end 
def call(env) 
@app.call(env) 


H 
H 


end 


Lead interloek 


主要 解决 eager_ load 和 cache classes 都 false 的 情况 下 ， 仍 然 能 很 好 的 处 理 并 发 
并 且 不 怎么 影响 性 能 。 


这 和 移 除 Rack::Lock 及 config.threadsafe! 有 一 定 关联 。 


简单 说 : Rack:Lock 多 进程 的 话 ， 它 没 能 解决 什么 实质 问题 ， 还 影响 性 能 。 多 
线程 的 话 ， 它 也 不 能 很 好 的 解决 问题 ， 并 且 还 暴露 出 自身 存在 的 缺陷 。 


本 模块 已 从 Rails 移 除 。 


Executor 


3E Rails 自 带 的 Middleware > reload 也 会 影响 到 。 但 它们 被 封装 到 
:Rack:BodyProxy 里 。 


引入 此 模块 的 同时 ， 把 Load Interlock 移 除 了 。 


Debug Locks 


死 锁 诊断 ， 有 具体 说 明 及 使 用 方法 ， 可 以 查看 官方 文档 。 


Action Dispatch Http 
在 一 次 完整 的 HTTP 里， 提供 客户 端的 request 对 象 ， 和 服务 端的 response 对 
Zo 


它 和 Web 服务 器 的 关系 比较 近 ， 影 响 的 主要 是 http 相关 的 部 分 (也 就 是 request 和 
response)， 和 我 们 的 业务 逻辑 没有 直接 关联 。 


虽然 ， 大 部 分 为 Controller 所 用 ， 但 要 区 别 开 来 。Controller 属于 MVC 里 的 > fe 
我 们 的 业务 逻辑 有 着 直接 关联 ， 而 它 不 是 这 样 的 。 


Request 和 Response 是 连接 ActionController 和 ActionDispatch::Http 主要 方式 ， 
另外 还 有 很 小 一 部 分 用 其 它 方式 实现 。 


每 一 个 请 求 都 有 request 和 response. 


request 为 ActionDispatch::Request 的 实例 对 象 。 
response 为 ActionDispatch::Response 的 实例 对 象 。 


Request 


常用 到 的 request， 它 还 有 很 多 方法 在 这 。 


除了 提供 众多 和 请 求 有 关 的 方法 外 ， 整 个 环境 也 很 重要 ， 例 如 Middleware 非常 需 


要 它们 ActionDispatch: :Request.new(env) 


Request 文件 下 的 内 容 


对 http://blog.test.example.com:3000/users?name-kelby 发 起 GET 请 求 。 
在 new 页 面 ， 对 http://blog.test.example.com:3000/users 发 起 POST 请 求 。 


查询 、 请 求 参数 


GET & query parameters 
=> {"name"=>"kelby"} 


=> d. 


POST & request_parameters 

=> {} 

=> {"utf8"=>"v", 
"authenticity_token"=>"+xxx.../yyy...==", 
"user"=>{"name"=>"kelby", "email"=>""}, 
"commit"=>"Create User"? 


请 求 方法 


form data? 
=> false 
=> true 


delete? 
=> false 
=> false 


get? 
=> true 
=> false 


head? 
=> false 
=> false 


patch? 
=> false 
=> false 


post? 
=> false 
=> true 


put? 
=> false 
=> false 


xhr? & xml_http_request? 

=> false 

=> nil 

local? # 来 自 本 地 请 求 ?用 正则 判断 ， 所 以 不 是 返回 true/false, 而 是 O/nil. 


=> 0 
=> 0 


些 数据 


media type 


=> wi 


=> "application/x-www- form-urlencoded" 


method 
=> "GET" 
=> "POST" 


method_symbol 


=> :get 
=> :post 
raw_post 
=> mW 


=> "utf8=%E2%9C%93&authenticity_token=%...%...%3D%3D ^n 
&user%5Bname%5D=kelby&user%5Bemail%5D=&commit=Create+User" 


request_method 
=> "GET" 
-» "POST" 


request method symbol 
=> :get 


=> :post 


server_software 


=> "thin" 
=> "thin" 
uuid 


=> "6c1c3684-d8aa-4c03-97d3-d179997773ef" 
=> "050daae4-c889-4d24-b627-ba682370216d" 


ssl? # KAT Rack: :Request， 当 前 是 否 在 是 用 https 加 密 协 议 。 
=> false 
=> false 


scheme # HT Rack::Request 
=> "http" 
=> "http" 


一 些 对 象 


headers 
=> ActionDispatch::Http::Headers 的 实例 对 象 (一 大 串 东 西 ) 
=> ActionDispatch::Http::Headers 的 实例 对 象 (一 大 串 东 西 ) 


authorization 
=> nil 
=> nil 


body 
=> StringIO 的 实例 对 象 
=> StringIO 的 实例 对 象 


content length 
=> 0 
=> 187 


cookie_jar 
=> ActionDispatch: :Cookies::CookieJar 的 实例 对 象 (一 大 串 东 西 ) 
=> ActionDispatch::Cookies::CookieJar 的 实例 对 象 (一 大 串 东 西 ) 


flash 
=> ActionDispatch::Flash::FlashHash 的 实例 对 象 
=> ActionDispatch::Flash::FlashHash 的 实例 对 象 


check path parameters! 
=> {:controller=>"users", :action=>"index"} 
=> {:controller=>"users", :action=>"create"} 


fullpath 

-» "/users?name-kelby" 
-» "/users" 

original fullpath 

-» "/users?name-kelby" 
-» "/users" 

original url 


-» "http://blog.test.example.com:3000/users?name-kelby" 
=> "http://blog.test.example.com:3000/users" 


AR F 3% IP 相关 


ip 

=> "127.0.0.1" 
=> "127.0.0.1" 
remote_ip 


= 
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其 它 方法 


key? 


deep_munge 


reset_session 
session options- 


parse query 


除 上 述 方法 外 ， 还 有 : 


include 
include 
include 
include 
include 


ActionDispatch: 
ActionDispatch: 
ActionDispatch: 
ActionDispatch: 
ActionDispatch: 


:Http: 
:Http : 
:Http : 
:Http : 
:Http : 


: Cache: : Request 

: MimeNegotiation 
:Parameters 
:FilterParameters 
: URL 


URL 

ay request 里 带 url 或 path 的 方法 有 几 个 和 它 相 关 。 

在 new 页 面 ， 对 http://blog.test.example.com:3000/users 发 起 POST 请 求 。 
检测 结果 (它们 是 实例 方法 ) : 


request.domain 
# => "example.com" 


request.host 

# => "blog.test.example.com" 
request.host with port # 取得 带 端 口 的 主机 名 
# => "blog.test.example.com:3000" 


request.optional port 
# => 3000 


request.port 
# => 3000 


request.port_string 
# => ":3000" 


request.protocol # 取得 当前 使 用 网 络 协议 
# => "http://" 


request.raw host with port # 代理 服务 器 的 主机 名 和 端口 
# => "blog.test.example.com:3000" 





request.server port 
# => 3000 


request.standard port # 返回 网 络 协议 标准 端口 (http 为 80, https A 44 
3 ) 
4 => 80 


request.standard port? 4 判断 当前 协议 是 否 是 标准 端口 
4 => false 


request.subdomain 
=> blog. rest” 
request.subdomain 2 
# = "blog" 


request.subdomains 
=> bloom test] 
request.subdomains 2 
poc | blog] 


request.url # 取得 当前 requset 完整 Url 


# => "http://blog.test.example.com:3000/users" 


除 上 述 方法 外 ， 还 有 (模块 方法 ) : 


extract domain 
extract subdomain 
extract subdomains 


full url for 
path. for 
url for 


以 ActionDispatch::Http::URL.x 的 形式 调用 它们 。 


数据 来 源 
env["HTTP X FORWARDED HOST"] 
env['HTTP HOST'], env['SERVER NAME'], env['SERVER ADDR'], env['S 


ERVER PORT'] 


以 及 父 类 Rack::Request ( 它 也 是 从 env 里 取 数 据 ， 然 后 处 理 。 具 体 不 在 此 描述 ) 


URL 


276 


Headers 


通过 它 可 以 访问 当前 环境 下 HTTP 请 求 头 (将 HTTP headers 转换 成 环境 变量 ) 
数据 结构 和 Hash 类 似 ， 所 以 提供 的 方法 也 类 似 ， 这 里 就 不 列举 了 。 
使 用 举例 : 

env = 4 CONTENISTYPESUES S bexbt/DL adm e 


headers = ActionDispatch: :Http::Headers.new(env) 
headers["Content-Type"] # => "text/plain" 


对 应 Rails 里 的 request.headers 而 不 是 headers 


前 者 ， 是 这 里 ActionDispatch::Http::Headers 的 实例 对 象 ; 而 后 者 ， 是 
ActionDispatch::Response.default headers 为 Hash 实例 对 象 ( 特 指 Http 
Response 里 的 Headers ) 
通过 它 ， 可 获取 很 多 CGI VARIABLES 相关 值 。 
Note: 它 包含 了 很 多 内 容 (少量 env, 一 般 rack, 很 多 action dispatch, 少量 
action controller) > &&:tzk TAA A e 


Mime Negotiation 


在 new 页 面 ， 对 http://blog.test.example.com:3000/users 发 起 POST 请 求 。 


MER: 


request.accepts 
=> [#<Mime: :Type:0x007f8a1a498cd8 Qstring-"text/html", Qsymbol-: 
html, \n 
@synonyms=["application/xhtml+ 

xml"]», 
H«Mime::Type:0x007f8a20f2f498 Qstring-"image/webp", Qsymbol-nil 
, @synonyms=[]>, 
#<Mime: : Type:0x007f8a1a48a908 Qstring-"application/xml", @symbo 
l=:xml, \n 

@synonyms=["text/xml", "applicati 
on/x-xml"]>, 
Z«Mime::Type:0x007f8a20f2f3f8 @string="*/*", Qsymbol-nil, @syno 
nyms=[]>] 


request.content_mime_type 
=> #<Mime::Type:0x007f8a1la47be58 Qstring-"application/x-www-form 
-urlencoded", \n 

@symbol=:url_encoded_form, @syn 
onyms=[ ]> 


request.content_type 
=> "application/x-www-form-urlencoded" 
= formats.first 
request.format 
=> #<Mime:: Type: 0x007f8a1a498cd8 @string="text/html", Qsymbol-:h 
tml, \n 
@synonyms=["application/xhtml+x 
m1"]» 


request.formats 
=> [#<Mime: :Type:0x007f8a1a498cd8 Qstring-"text/html", Qsymbol-: 
html, \n 

@synonyms=["application/xhtml+ 
xml" ]>] 


除 上 述 方法 外 ， 还 有 : 


negotiate mime 
format- 


formats- 
variant- 


给 "变种 "增加 了 一 些 新 的 方法 : 


request.variant = :phone 
request.variant.phone? # true 
request.variant.tablet? # false 


request.variant - [:phone, :tablet] 
request.variant.phone? H 
request.variant.desktop? # 


request.variant.any?(:phone, :desktop) # 


request.variant.any?(:desktop, :watch) 


Parameters 
常用 到 的 params (XL "| parameters) t ° 
parameters & params 


path parameters 


在 new 页 面 ， 对 http://blog.test.example.com:3000/users 发 起 POST 请 求 。 


检测 结果 : 


request.parameters 

=> {"utf8"=>"v", 
"authenticity_token"=>"+.../hHjJOC5A07CxXYwlej yghpNM3elUVw--", 
"user"=>{"name"=>"kelby", "email"=>""}, 
"commit"=>"Create User", 
"controller"=>"users", 
"action"=>"create"} 


EE 

request.parameters -- params 
-» true 

# 但 它们 两 者 并 不 是 完全 等 价 的 


request.path parameters 
=> {:controller=>"users", :action=>"create"} 


Parameter Filter & Filter Parameters 


过 滤 参 数 。 如 : 


env["action dispatch.parameter filter"] = [:password] 
4 => replaces the value to all keys matching /password/i with "[ 
FILTERED]" 


这 就 是 为 什么 我 们 在 日 志 里 看 不 到 password 的 值 ， 而 是 显示 FILTERED 的 原因 。 


实例 方法 : 
filter 
# 具体 包含 下 面 3 ANZ: 


filtered parameters 
filtered env 
filtered path 


在 new 页 面 ， 对 http://blog.test.example.com:3000/users 发 起 POST 请 求 。 


检测 结果 : 


filtered env 
# => 一 大 串 env 相关 数据 


request.filtered parameters 
4 => ("utf8"z»"v", 
"authenticity token"z»"-.../hHjOC5Ao7CxXYwlej yghpNM3elUVw--", 
"user"=>{"name"=>"kelby", "email"=>""}, 
"commit"=>"Create User", 
"controller"=>"users", 
"action"=>"create"} 


request.filtered_path 
# => "/users" 


rarameter Filter & Filter Farameters 


使 用 举例 : 


# 用 "[FILTERED]" 替换 /password/i 
env["action dispatch.parameter filter"] = [:password] 


# 用 "[FILTERED]" 替换 /foo|bar/i 
env["action dispatch.parameter filter"] = [:foo, "bar"] 


以 上 直接 使 用 env 比较 少见 ， 更 多 的 用 法 是 : 


4 filter parameter logging.rb 
Rails.application.config.filter parameters += [:password] 


查看 应 用 程序 过 滤 了 什么 字段 : 
Rails.application.config.filter parameters 
除 上 述 方法 外 ， 还 有 : 
env filter 
filtered query string 


parameter filter for 


parameter filter 


Note: 用 得 比较 多 的 是 方法 parameter filter， 通 常用 来 配置 过 滤 :password .… 
过 滤 的 其 实 是 ParameterFilter 的 实例 对 象 ， 虽 然 这 里 没有 体现 出 来 。 


NO 
Co 


Cache < Request 


HTTP Cache 里 的 Request 部 分 。 如 : 检测 ETag ^ Cache-Control 


这 


一 般 来 说 ， 客 户 端 (通常 是 浏览 器 ) 也 有 缓存 机 制 ， 我 们 可 以 设置 ETag 和 Last- 
Modified 告诉 它们 资源 是 否 已 更 新 ， 缓 存 是 否 已 过 期 。 


一 般 来 说 ， 我 们 不 会 手动 调用 这 里 的 方法 。 
提供 方法 : 

etag matches? 

fresh? 

if modified since 

if none match 


if none match etags 


not modified? 


上 传 文件 时 用 到 ， 黑 认 文 件 放 到 :tempfile € > 48 X & Hl FZ CRA o 


close 
open 
read 
rewind 


path 
size 


eof? 


在 Http Parameters fe Metal Parameters 里 有 用 到 它 ， 对 应 params 里 有 :tempfile 
和 params.permit(:x) 里 包含 文件 对 象 时 处 理 。 


使 用 举例 : 


Factory.define :image do |o| 
file = File.new(Rails.root + 'spec/fixtures/images/rails.png' ) 
file. rewind 


o.file ActionDispatch: :Http: :UploadedFile.new(:tempfile => fil 
e, 
:filename => Fil 
e.basename( file) ) 
end 


@image = Factory(:image) 


Utils 


执行 GET 或 POST 请 求 时 ， 对 参数 进行 检测 ， 不 是 UTF-8 可 能 会 报错 。 但 ， 实 际 
上 它 起 的 作用 很 小 。 


Response 


常用 到 的 response， 它 还 有 很 多 方法 在 这 。 


Response 文件 下 的 内 容 
和 ENV 有 关 的 方法 : 


auth_type 
gateway interface 
path translated 


remote host 
remote ident 
remote user 
remote addr 


server name 
server protocol 


accept 

accept charset 

accept encoding 
accept language 


cache control 
from 
negotiate 
pragma 


abort 


await commit 
await sent 


body 
body- 
body parts 


close 


code 


commit ! 


committed? 


content type- 


cookies 


delete cookie 


location & redirect url 
location- 


message & status message 


response code 


sending! 
sending? 


sent! 
sent? 


set cookie 


status- 


to a & prepare! 
to ary 


Fil Redi 
filtered location 

配置 config.filter_redirect， 可 以 从 日 志 里 过 滤 掉 一 些 敏感 的 " 重 定向 地 址 " : 
config.filter redirect «« 'www.rubyonrails.org' 

可 以 使 用 字符 事 、 正 则 表达 式 ， 或 者 一 个 数组 (包含 字符 串 或 正则 表达 式 ) : 


config.filter redirect.concat ['www.rubyonrails.org', /private p 
ath/] 


匹配 的 URL 会 显示 为 [FILTERED]'。 


查看 应 用 程序 过 滤 了 什么 字段 : 


Rails.application.config.filter redirect 


Cache < Response 


HTTP Cache 里 的 Response # 7 » 4 : it £ ETag ^ Cache-Control. 


一 般 来 说 ， 客 户 端 (通常 是 浏览 器 ) 也 有 缓存 机 制 ， 我 们 可 以 设置 ETag 和 Last- 
Modified 告诉 它们 资源 是 否 已 更 新 ， 缓 存 是 否 已 过 期 。 


一 般 来 说 ， 我 们 不 会 手动 调用 这 里 的 方法 。 


提供 方法 : 


date 
date- 
date? 


etag- 

weak etag- 
strong etag- 
etag? 

weak etag? 
strong etag? 


last modified 
last modified- 
last modified? 


x 


/一 > 


7. 65 


TODO 


Rack Cache 


Rack::Cache 也 属于 Rack middleware， 可 用 后 端 服务 存储 assets(3$ A IR) A 


容 ， 默 认 放 在 public/ 目录 下 。 


现在 默认 没有 采用 : 


config.action dispatch.rack cache = false 


你 可 以 配置 ， 如 : 


Rails.configuration.action dispatch.rack cache 
4 => {:metastore=>"rails:/", :entitystore=>"rails:/", 
false} 


Rails 对 应 有 Rails Meta Store 和 Rails Entity Store 类 ， 它 们 都 有 : 


def initialize(store = Rails.cache) 
Qstore - store 
end 


# LAB A xt @store 的 read ` write 等 方法 。 


链接 rack-cache 


:verbose=> 


Mime Type register 


设置 响应 类 型 Mime Type. 
先 看 看 register 方法 


第 1，2 个 参数 容易 理解 
第 3 个 为 标准 类 型 
第 4 个 为 扩展 类 型 


使 用 举例 : 


Mime::Type.register "text/html", :html, %w( application/xhtml+xm 
1 ), %w( xhtml ) 


register 只 是 登记 ， 本 身 是 没有 处 理 能 力 的 ， 还 需要 使 用 Action Controller 添 
加 泻 染 器 并 处 理 : 


ActionController::Renderers.add ... 


查看 Rails 支持 什么 类 型 的 MIME(Multipurpose Internet Mail Extensions > % M38 
互联 网 邮件 扩展 ) : 


Mime::SET 


=> [£Z«Mime::Type:0x007fdf7fO1d9fO 

Qstring-"text/html", 

@symbol=:html, 

@synonyms=["application/xhtml+xml"]>, 

#<Mime: : Type :0x007fdf7f01d6f8 

@string="text/plain", 

@symbol=:text, 

@synonyms=[]>, 

#<Mime: : Type: 0x007fdf7F01d400 

@string="text/javascript", 

@symbol=:js, 

@synonyms=["application/javascript", "application/x-javascript 
"I 

#<Mime: :Type:0x007fdf7f01d158 @string="text/css", Qsymbol-:css, 
@synonyms=[ ]>, 


Session 
在 文件 目录 上 很 有 意思 ， 它 不 是 放 在 http/ 而 是 放 在 单独 的 request/ 目录 下 。 


这 是 因为 和 其 它 http/ 下 的 模块 相 比 ， 它 不 仅 被 request 调用 ， 同 时 它 在 
middleware Flash 里 也 被 调用 。 


Action Dispatch RouteSet 底层 


Routing 定义 应 用 的 路 由 后 ， 由 RouteSet 底层 实现 。 


本 章节 偏 低层 ， 如 果 你 不 能 掌握 ， 可 以 先 跳 过 。 


RouteSet 概述 


e 4448 route set.rb 及 routes proxy.rb 两 文件 

e 本 身 就 充满 魔法 ， 是 Routing 里 的 一 个 模块 。 
e 还 是 内 外 沟通 的 桥梁 。 

内 指 Journey. 

e 外 指 对 外 的 接口 及 routing 目录 里 的 其 它 内 容 。 


require 'action dispatch' 
routes - ActionDispatch::Routing::RouteSet.new 


routes.draw do 

get '/' => 'mainpage#index' 

get '/page/:id' => 'mainpage#show' 
end 


从 Action Dispatch 转换 站 场 到 Action Controller. (准确 点 : Action Dispatch -> 
Metal -> Abstract Controller -> Action Controller) 


# route_set.rb 
def dispatch(controller, action, env) 


controller .action(action).call(env) 
end 


Me bik op > 334: 


Routes Proxy # 从 RouteSet 里 抽取 而 来 


Action Dispatch RouteSet 底层 实现 路 由 
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实例 对 象 和 各 个 实例 方法 


实例 对 象 


在 Rails 源 代 码 里 ， app.routes 指 的 是 RouteSet 的 实例 对 象 。 


4 action mailer/railtie.rb 

extend ::AbstractController::Railties::RoutesHelpers.with(app.ro 
utes, false) 

include app.routes.mounted helpers 


# action controller/railtie.rb 

include app.routes.mounted helpers 

extend ::AbstractController::Railties::RoutesHelpers.with(app.ro 
utes) 


4 action dispatch/routing/mapper.rb 
app.routes.define mounted helper(name) 
app.routes.extend Module.new ( ... ) 


4 rails/application/finisher.rb 


app.routes.append do ... end 
app.routes.define mounted helper(:main app) 


在 Rails 源 代码 里 ，@set 有 时 候 也 是 RouteSet 的 实例 对 象 ， 如 Mapper € : 


# action dispatch/routing/mapper.rb 
initialize 
Qset = set 
@scope = Scope.new(( :path names => Qset.resources path names 


}) 


dispatcher 
@set.dispatcher defaults 


default_url_options= 
@set.default_url_options = options 


has_named_route? 
@set.named_routes.routes[name.to_sym] 


define_generate_prefix 
_route = Qset.named routes.get name 
routes = @set 


add_route 

mapping = Mapping.build(@scope, @set, URI.parser.escape(path), 
as, options) 

@set.add_route(app, conditions, requirements, defaults, as, an 
chor ) 


name for action 
candidate unless candidate !~ /NA[ a-z]/i || Gset.named routes 
. key? (candidate) 


也 正 因 为 如 此 ， 除 了 draw 和 add routes 外 ， 我 们 可 以 在 代码 里 搜索 ， 看 哪 
里 的 代码 影响 了 路 由 规则 的 生成 。 


实例 对 象 和 各 个 实例 方法 


# route set.rb 

attr accessor :formatter, :set, :named routes, :default scope, 
router 

attr accessor :disable clear and finalize, :resources path names 
attr accessor :default url options, :request class 


alias :routes :set 


formatter Æ Journey::Formatter 的 实例 对 象 
set 是 Journey: :Routes 的 实例 对 象 


日 


named routes 是 NamedRouteCollection 的 实例 对 象 


a 


router Æ Journey::Router 的 实例 对 象 


dk dk dk Gb dk 


resources path names 也 就 是 default resources path names: KUA 
: new 和 edit 
# request class 默认 是 ActionDispatch: :Request 


各 个 实例 方法 


inspect & to s 
routes & set 


draw 

4 往 变量 @append 和 Qprepend £X 
append 

prepend 


finalize! 


4 消除 named routes ^ set » formatter 
clear! 


dispatcher 


# 包含 了 所 有 Engine 提供 的 helper 方法 ， 和 main app 方法 。 
mounted helpers 


4 #38 Engine 提供 的 helper Zik 
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实例 对 象 和 各 个 实例 方法 


# 用 到 了 MountedHelpers 和 RoutesProxy 
define mounted helper 


# 它 其 它 是 一 个 Module 
# 所 以 我 们 可 以 include Rails.application.routes.url helpers 
# 包含 了 所 有 和 URL 有 关 的 helper 方法 (也 就 是 所 有 x url 和 x path 方法 ) 。 


url helpers 


# 没有 路 由 规则 ? 
empty? 


会 调用 到 以 下 方法 : 
build path 

build conditions 
Qset.add route 


ik dk dk Gb dt 


named routes[name] 
add route 


extra keys 
generate extras 


# generate extras 和 url for 调用 到 
generate 


# 我 们 在 路 由 规则 是 可 以 带 默 认 参 数 的 ， 这 在 定义 的 时 候 就 可 以 知道 。 
# 这 里 的 意思 其 实 是 : 有 默认 参数 吗 ? 
optimize routes generation? 


find script name # url for 调用 到 


# 可 谓 是 其 它 组 件 url for 方法 的 源头 
# (当然 ， 得 用 到 路 由 方法 才 行 ) 

url for 

path for # 简单 封装 url for 


# 浏览 器 里 输入 的 网 址 ， 最 先 经 过 它 解 析 
H 关键 部 分 是 调用 @router.recognize 
recognize path 


工大 可 


302 


recognize path 使 用 举例 : 


Rails.application.routes.recognize path "http://localhost:3000/u 
sers/1" 
4 => {:controller=>"users", :action=>"show", :id=>"1"} 


通过 这 一 步 ， 外 部 URL 已 经 被 转换 成 了 Rails 能 够 识别 的 语言 。 在 这 之 后 ，Rails 
息 怎 么 处 理 就 怎么 处 理 。 


# 使 用 Journey 处 理 我 们 提供 的 路 由 规则 ， 得 到 path 这 部 分 
build path 


draw 直接 对 外 暴露 的 接口 ， 初 始 化 Mapper 对 象 。 然 后 交还 各 个 模块 处 理 。 本 
质 是 : 运用 Mapper， 处 理 config/routes.rb 里 的 代码 。 


相关 代码 : 
mapper = Mapper.new(self) 
if default scope 
mapper.with default scope(default scope, &block) 
else 


mapper.instance exec(&block) 
end 


之 后 ， 就 是 执行 【路 由 常用 方法 汇总 】 章 节 里 提 到 的 方法 。 
initialize 用 到 了 NamedRouteCollection * 7j XX : 


self.named routes - NamedRouteCollection.new 


初始 化 了 几 个 有 意义 的 变量 ， 如 : named routes ^ @set ^ @router ^ @formatter 


generate 用 到 了 Generator， 内 容 是 : 


Generator.new(route key, options, recall, self).generate 


dispatcher 用 到 了 Dispatcher AŽ : 


Routing: :RouteSet::Dispatcher.new(defaults) 


Named Route Collection 
向 Rails # È a HR 4% wh 485 X x path, x url 方法 。 


include Enumerable， 所 以 看 到 很 多 同名 方法 也 就 不 奇怪 了 。 它 们 意义 和 使 用 方式 
雷同 ， 不 再 一 一 解释 。 
module ActionDispatch 
module Routing 
class RouteSet 


def initialize(request class = ActionDispatch::Request) 
self.named routes - NamedRouteCollection.new 


routes 

url helpers module 
route defined? 
helper names 
clear! & clear 


add & []= # 主要 作用 ， 添 加 X_ url 和 x path 辅助 方法 
get & [] 


names 


path helpers module 


除 上 述 方法 外 ， 还 有 : 
key? 

each 

length 


另外 ， 还 有 私有 方法 define url helper 
我 们 使 用 的 路 由 相关 的 X_url fe x path 辅助 方法 就 是 由 它 而 来 的 。 


def define url helper(mod, route, name, opts, route key, url str 
ategy) 


helper - UrlHelper.create(route, opts, route key, url strategy 


mod.module eval do 
define method(name) do |*args| 


end 
end 


end 
非常 底层 的 实现 ， 主 要 对 外 接口 self.create 


当 调 用 Named Route Collection 的 私有 方法 define_url_helper 时 会 用 到 ， 部 分 内 
ER: 


helper = UrlHelper.create(route, opts, route key, url strategy) 


哪里 调用 它 了 ? 
1) Qset.add route 添加 路 由 规则 时 有 调用 named routes[name] 


2) 而 named routes 就 是 NamedRouteCollection 的 实例 对 象 : 


attr accessor :named routes 


def initialize 
self.named routes - NamedRouteCollection.new 
end 


3) 并且 []= 方法 实际 就 是 add 方法 ， 而 add 又 调用 了 上 面 的 define url helper 


将 HTTP 请 求 向 具体 的 Controllertaction 转移 。 
继承 于 Routing::Endpoint 
module ActionDispatch 
module Routing 
class RouteSet 
def dispatcher(defaults) 
Routing::RouteSet::Dispatcher.new(defaults) 
end 
end 


end 
end 


实例 方法 : 
dispatcher? 
serve 
prepare params! 


controller 


私有 方法 : 
dispatch 
controller reference 


normalize controller! 
merge default action! 


最 重要 的 方法 是 dispatch ， 将 战场 切换 到 Controller#action 


def dispatch(controller, action, env) 
controller.action(action).call(env) 
end 


每 一 条 路 由 规则 ， 对 应 着 一 个 Dispatcher 实例 。 
每 一 个 路 由 规则 转换 着 draw 对 应 一 个 Dispatcher 实例 。 
用 最 简单 的 get 方法 举例 : 


AppName: :Application.routes.draw do 
get 'photos/:id' => 'photos#show', :defaults => { :format => ' 


jpg' } 
end 
生成 实例 : 


app: #<ActionDispatch: :Routing: :RouteSet: :Dispatcher :0x007fd05e0 
cf7e8 
@defaults={:format=>"jpg", :controller=>"photos", :ac 
tion=>"show"}, 
@glob_param=nil, 
@controller_class_names=#<ThreadSafe: :Cache:0x007fd05 
eOcf7cO 
@backend={}, 
@default_proc=nil>> 
conditions: {:path_info => "/photos/:id(.:format)", 
:required_defaults => [:controller, :action], 
:request method => ["GET"]} 
requirements: {} 
defaults: {:format=>"jpg", :controller=>"photos", :action=>"show" 
} 
as: nil 
anchor: true 


[| 
app 如 果 条 件 匹 配 ， 将 要 执行 的 Rack application. 


conditions 匹配 条 件 。 执 行 此 Rack application 要 匹配 什么 条 件 。 


defaults 默认 参数 。 
requirements 对 应 方法 里 的 :constraints 参数 。 


as 对 应 方法 里 的 :as 参数 。 


Generator 
url for 方法 的 重要 组 成 部 分 。 


module ActionDispatch 
module Routing 
class RouteSet 
def generate(route key, options, recall = {}) 
Generator.new(route key, options, recall, self).generate 
end 
end 
end 
end 


生成 失败 的 话 ， 会 报 UrlGenerationError 错误 。 


各 个 实例 方法 : 
generate 


# 以 下 几 个 方法 initialize 时 被 调用 
normalize recall! 

normalize options! 

normalize controller action id! 
use relative controller! 
normalize controller! 

normalize action! 


initialize 和 generate 对 外 提供 的 接口 。 


除 上 述 外 ， 还 有 : 


和 


use recall for 


controller 
current controller 


different controller? 


attr reader :options, 


‘recall, 


:set, 


:named route 


Routes-Proxy 


Rails 项 目 ， 默 认 使 用 main app 而 使 用 gem 'rails admin' 的 话 ， 会 有 
rails admin 相关 路 由 。 它 们 都 是 RoutesProxy 的 实例 。 


module ActionDispatch 
module Routing 
class RouteSet 
def define mounted helper(name) 
# .. 


routes = self 
MountedHelpers.class_eval do 
define_method "_#{name}" do 
RoutesProxy.new(routes, _routes_context) 
end 
end 


1 ne 
end 
end 
end 
end 


mount SomeRackApp, at: "some route" 


如 果 mount 的 Engine 恰好 也 是 一 个 Rails app > P Z A A s 4 0 HH dq 
helper 方法 。 


x 


此 时 ，Engine A 9} > Engine 之 间 如 何 通信 ?通过 代理 (也 就 是 Routes Proxy 的 实 
| xt R) > 


路 由 生成 、 解 析 底 层 实 现 
重要 组 成 部 分 有 : 
e Routes 


e Router 


e Formatter 


RouteSet 里 调用 到 它 的 几 个 方法 : 


initialize 


module ActionDispatch 
module Routing 
class RouteSet 
attr accessor :formatter, :set, :named routes, :default sc 
ope, :router 
attr accessor :disable clear and finalize, :resources path 





. names 
attr accessor :default url options, :request class 


alias :routes :set 
def initialize(request class - ActionDispatch::Request) 


self.named routes = NamedRouteCollection.new 
self.class.default resources 


self.resources path names 


. path names 
self.default url options = {} 
self.request class - request class 
@append zd 
@prepend = [] 
Qdisable clear and finalize = false 
Qfinalized = false 
Qset = Journey: :Routes.new 
@router = Journey: :Router.new @set 
@formatter = Journey: :Formatter.new @set 

end 
end 
end 
end 


build_path 


module ActionDispatch 
module Routing 
class RouteSet 
def build path(path, ast, requirements, anchor) 
strexp = Journey: :Router: :Strexp.new( 

ast, 
path, 
requirements, 
SEPARATORS, 
anchor ) 


pattern = Journey: :Path: :Pattern.new(strexp) 


builder = Journey: :GTG::Builder.new pattern.spec 


# Get all the symbol nodes followed by literals that are 
not the 
# dummy node. 
symbols = pattern.spec.grep( Journey: :Nodes: :Symbol).find 
_all { |n] 
builder.followpos(n).first.literal? 


pattern 
end 
end 
end 
end 


call 


module ActionDispatch 
module Routing 
class RouteSet 
def call(env) 
req - request class.new(env) 
req.path info - Journey::Router::Utils.normalize path(re 
q.path info) 
Qrouter.serve(req) 
end 
end 
end 
end 


recognize path 


module ActionDispatch 
module Routing 
class RouteSet 
def recognize path(path, environment = {}) 
method = (environment[:method] || "GET").to s.upcase 
path = Journey::Router::Utils.normalize path(path) unless 
path =~ %r{://} 
extras = environment[:extras] || {} 


env = Rack: :MockRequest.env_for(path, {:method => method 


3) 
req - request class.new(env) 
Qrouter.recognize(req) do |route, params| 

# 
end 
end 
end 
end 
end 





路 由 已 经 定义 ， 请 求 过 来 如 何 匹配 ? 


之 前 用 的 是 正则 匹配 ， 例 如 "/pictures/A12345" 可 以 匹配 到 : 


get 'pictures/:id' => 'pictures#show', :constraints => { :id => 
/[A-Z]\d{5}/ } 


引入 journey 后 , 性 能 及 其 它 各 方面 都 有 了 很 大 的 改善 。 


报错 ActionController::UrlGenerationError 


4 Formatter 尝试 使 用 generate 将 params 传递 过 来 的 参数 解析 ， 但 是 解析 
不 了 的 时 候 ， 就 会 报 此 错误 。 


Action Cable 


TODO 


服务 端 - Ruby 代码 


TODO 


Channel 


直接 调用 。 类 似 Controller .… P3835 RR * MVC 里 最 先 由 它 处 理 。 


它 处 理 从 客户 端 过 来 的 ws 请 求 。 


Base 


完成 请 求 转发 ， 由 Action Dispatch 到 具体 的 Channel#action. 
身份 地 位 相当 于 Action Controller 里 的 Metal + Abstract Controller 里 的 Base. 


另外 ， 它 是 Channel 的 头 : 


include Callbacks 
include PeriodicTimers 
include Streams 
include Naming 

include Broadcasting 


内 部 处 理 


Channel 整体 结构 比 Controller 简单 ， 这 里 的 Base 就 相当 于 Action Controller 里 
的 Metal. 


它 有 类 方法 action methods 、 实 例 方法 perform action 和 私有 方法 
dispatch action 等 。Action Dispatch 转发 请 求 过 来 后 ， 主 要 由 它 进 行 处 理 ， 
转 给 具体 的 Channel#action. 


区 别 也 是 有 的 ， 这 边 的 请 求 不 需要 Middleware 进行 处 理 ， 所 以 它 没有 调用 到 ， 而 
Metal 需要 。 


对 外 提供 接口 


类 方法 : 


action methods 


method added 


clear action methods! 


实例 方法 : 


attr reader :params, :connection, :identifier 


delegate :logger, to: :connection 


perform action 


unsubscribe from channel 


perform action public send 后 执行 我 们 自 定 义 的 action. 


# connection AR 


transmit 


ll aS i ee eee rd] 
VA TATA TR GS d 


subscribed 
unsubscribed 


reject 


defer subscription confirmation? 
defer subscription confirmation! 


subscription confirmation sent? 
subscription rejected? 


默认 其 子 类 要 重 写 subscribed 和 unsubscribed 
subscribed 相当 于 初始 化 。 


如 果 不 允许 订阅 ， 可 以 用 reject 进行 拒绝 。 


方法 。 


transmit €R ÆR > RAIA ActionCable.connection 执行 。 


在 这 里 ， reject 和 transmit %%% Controller € render 和 redirect to 
一 样 的 东西 。 


Streams 


# pubsub.subscribe 
stream from 


# pubsub.unsubscribe 
stop all streams 


4 封装 stream from 
stream for 


Note: 由 pubsub 完成 实际 操作 。 


class CommentsChannel < ApplicationCable::Channel 
def follow(data) 


stream from "comments for £Z(data['recording id']}" 
end 


def unfollow 
stop all streams 
end 
end 


CommentsChannel.broadcast_to(@post, Qcomment) 


Connection 终于 有 了 自己 的 一 点 处 理 能 力 ， 虽 然 小 ， 但 你 可 以 选择 使 用 ， 也 可 放 


Fo 


常用 stream from 以 处 理 一 对 一 消息 ; stop all streams 单方 面 即 可 中 止 服 


务 。 stream for 和 stream from 类 似 ， 只 是 多 了 一 个 空间 。 


stream from -> connection.transmit -> Connection#transmit -> Web 
Socket#transmit 


@websocket = ::WebSocket::Driver.websocket?(env) ? ClientSocket. 
new(env, event target, stream event loop) : nil 


Channel 补充 

Broadcasting 

类 方法 : 
broadcast to(model, message) 
broadcasting for 

CREM’ KARA ActionCable.server 执行 。 

Callbacks 

相关 回调 操作 : 


after subscribe & on subscribe 
after unsubscribe & on unsubscribe 


before subscribe 
before unsubscribe 


Naming 
channel name 
通过 此 方法 ， 可 以 获取 通道 名 字 : 


ChatChannel.channel name ha 
Chats::AppearancesChannel.channel name 


Periodic Timers 


periodically(callback, every:) 


可 以 在 Channel 里 使 用 的 类 方法 ， 周 期 性 的 执行 某 个 指定 的 回调 或 action. 


HENKE UTAH SET > 


Connection 


Base 
这 里 的 "连接 "几乎 等 价 于 Websocket 连接 。 


# 简单 封装 transmit 


beat 

close 

# 不 要 直接 调用 ， 应 由 connect^ disconnect 触发 
process 

receive 


send async 


statistics 
# 不 要 直接 调用 ， 应 由 Channel 实例 对 象 的 transmit 触发 
transmit 


其 子 类 里 的 public 实例 方法 ， 可 直接 调用 。 


注意 : TAEZ (Ra) 父 类 的 方法 ， 但 区 别 于 public 实例 方法 ， 不 能 直接 调用 。 


class AppearanceChannel « ApplicationCable::Channel 


def subscribed 


Qconnection token = generate connection token 


end 


def unsubscribed 


current user.disappear Qconnection token 


end 


def appear(data) 


current user.appear Qconnection token, on: 


n'] 


end 


def away 
current user.away Qconnection token 
end 


private 
def generate connection token 
SecureRandom.hex(36) 
end 
end 


data['appearing o 


示例 代码 中 ， subscribed 和 unsubscribed 由 父 类 定义 ， 不 能 直接 调 


用 。 generate_connection_token 私有 方法 ， 不 能 直接 调用 。 


appear 和 away 可 以 直接 调用 。 


其 它 方法 : 


attr reader :server, :env, :subscriptions, 
delegate :event loop, :pubsub, to: :server 


例如 ， 使 用 logger 


logger.add tags current user.name 


:logger, 


:worker_pool 


另外 ， 它 提供 的 一 些 protected 方法 也 很 实用 : 
request 


cookies 


这 里 的 request 是 ActionDispatch::Request 的 实例 对 象 ， 所 以 通过 它 也 可 以 获 
取 到 一 些 和 请 求 有 关 的 数据 。 


Identification 
RAK: 


identified_by 


常用 identified by 进行 身份 验证 。 


实例 方法 : 


connection identifier 


Authorization 


reject unauthorized connection 


常用 reject unauthorized connection 进行 报错 ， 只 能 被 动 地 等 着 被 调用 。 


Connection 补充 
WebSocket 


alive?() 
possible?() 


transmit(data) 


Tagged Logger Proxy 


add tags(*tags) 
tag(logger ) 
debug 

info 

warn 

error 


fatal 
unknown 


log(type, message) 


InternalChannel 


表示 带 有 同一 identifier 的 connection > 4f 3 Channel. 


Message Buffer 


append(message) 
process!() 


processing?() 


Sul ipti 
add(data) 
execute command(data) 
identifiers() 
perform action(data) 
remove(data) 
remove subscription(subscription) 


unsubscribe from all() 


Stream-Event Loop 


Connection 补充 


332 


Server 


Rails 默认 使 用 的 实例 是 Actioncable.server FRY Base 提供 的 实例 方法 外 ， 
它 还 可 调用 Broadcasting 和 Connections 提供 的 方法 。 


服务 端 向 客户 端 发 送 Ws 请 求 。 


Base 
实例 对 象 有 : ActionCable.server 
实例 方法 : 


# 所 有 Channel X 
channel classes 


4 identified by 指定 的 标识 符 
connection identifiers 


4 streams/broadcasting 所 使 用 的 适配器 
# ActionCable::SubscriptionAdapter::Async 实例 
pubsub 


4 ActionCable::RemoteConnections 实例 
remote connections 


# ActionCable::Connection::StreamEventLoop 实例 
stream event loop 


4 ActionCable::Server::Worker 实例 
worker pool 


# 断 开 带 有 某 标识 符 的 连接 
disconnect 


4 ActionCable::Server::Configuration ## 


config 
类 方法 : 


logger 


Broadcasting 
发 送 消息 给 指定 channel 的 订阅 者 。 
实例 方法 : 

broadcast 


broadcaster for 


常用 broadcast 进行 广播 。 


ActionCable.server.broadcast "web notifications 1", 
i title: "New things”, body: "All shit fit for print’ } 


实际 上 广播 任务 由 server 对 应 的 pubsub 来 完成 。 


广播 与 接收 一 般 要 对 应 
ActionCable.server 用 于 广播 ， 它 包括 标识 及 数据 。 


ApplicationCable::Channel 用 于 接收 数据 并 处 理 ， 特 定 的 Channel 一 般 只 接收 有 特 
定 标识 的 server 发 过 来 的 请 求 。 


Server 补充 


Connections 


手动 添加 、 移 除 链接 ， 主 要 为 了 方便 开发 、 调 试 ， 建 议 请 不 要 做 它 用 。 


connections 


add connection 
remove connecti 


on 


setup heartbeat timer 


open. connection 


Configuratio 


S statistics 


n 


实例 对 象 : ActionCable.server.config 


attr accessor 
attr accessor 
attr accessor 
attr accessor 
est origins 

attr accessor 


channel paths 


channel class n 


Lb lf qa BS OX 


LC /t) Hy Ze AU 25 


pubsub_adapter 


Worker 


‘logger, :log_tags 

:connection class, :worker_pool_size 
:redis, :channels path 

:disable request forgery protection, 


‘url 


ames 


x redis 


:allowed requ 


Server.send async 


Active Record Connection Management 


及 时 清理 Active Record 的 链接 ， 防 止 堆 积 成 山 。 


Remote Connections 


针对 使 用 了 identified by 的 连接 ， 方 便 对 其 进行 批量 处 理 ， 它 并 不 是 什么 特 
殊 概念 。 


第 一 部 分 : 


where 
module ApplicationCable 
class Connection « ActionCable::Connection::Base 
identified by :current user 


end 
end 


H $ 断 开 连接 
ActionCable.server.remote connections.where(current user: User.f 
ind(1)).disconnect 


disconnect 


identifiers 


它们 只 是 调用 ， 实 际 工 作 由 server 完成 。 


Action Cable Helper 


提供 action cable meta tag 方法 ， 用 于 创建 action-cable-url， 保存 url. 


在 ActionCable 的 Consumer 创建 WebSocket 链接 时 需要 它 url. 
当然 了 ， 这 是 自动 完成 的 。 


Subscription Adapter 

用 于 适 配 ActionCable 的 存储 方案 ， 默 认 是 Redis. 

具体 的 存储 方案 ， 只 要 实现 下 列 几 个 方法 即 可 : 
broadcast(channel, payload) 


subscribe(channel, message callback, success callback - nil) 
unsubscribe(channel, message callback) 


shutdown 


在 Server#pubsub 时 会 用 到 它 来 临时 存储 数据 。 


Subscription Adapter 补充 


目前 有 Async ` EventedRedis ` Inline ` PostgreSQL ` Redis ` SubscriberMap 等 
6 种 适 配 。 


Z P 34 - Coffee 脚本 

我 们 用 脚本 生成 Channel 时 ， 一 般 地 都 有 对 应 的 Coffee 脚本 。 
Consumer 开动 机 器 ，Subscription 接受 命令 ，Connection Ti ° 
Rails 默认 使 用 App.cable 表示 其 Consumer 实例 。 

4 种 调用 


e 约定 调用 的 coffee 方法 

e 外 部 直接 调用 coffee 方法 
e 内 部 调用 自己 的 方法 

e 调用 Channel 里 的 action 


Action Cable 文件 下 的 内 容 


根据 action-cable-url 内 容 ， 得 到 wss 协议 的 链接 ， 然 后 构造 Consumer. 


getConfig 
createwebSocketURL 
createConsumer 


startDebugging 
stopDebugging 


Consumer 
创建 各 个 相关 的 实例 对 象 ， 并 间接 具有 发 送 @webSocket 消息 的 能 力 。 
创建 各 个 相关 的 实例 对 象 。 


由 Consumer 根据 action-cable-url 得 到 url (使 用 协议 ws)， 创 建 WebSocket 实 
例 o 


constructor 


一 并 创建 Subscriptions ` Connection & Connection Monitor 实例 。 


并 间接 具有 发 送 @webSocket 消息 的 能 力 。 


Send 


想 通 过 @webSocket 发 送 消息 ， 可 以 通过 Consumer 实例 完成 (尽管 它 是 封装 的 
Connection 对 象 )。 


Subscription 
ib TH > VRB EFF © 
传递 消息 到 Channel#action 


常用 的 : 


| rus send 


perform 


unsubscribe 


创建 subscription # channel. 


常用 方法 perform 可 以 在 Coffee 里 调用 Channel 里 的 action. 


Subscription#perform -> Subscription#send -> Consumer#send -> Co 
nnection#send -> WebSocket#send 


EHE > ARETE 


我 们 可 以 (和 普通 JS 一 样 ) 在 它 的 基础 上 自 定义 方法 ， 进 行 调用 。 


Connection 


表面 操作 的 是 connect， 实 质 是 直接 操作 websocket ... 


send 
open 
close 


reopen 


disconnect 


它 所 打开 、 连 接 的 就 是 WebSocket 连接 。 


isOpen 
isState 


getState 
installEventHandlers 
events 


不 过 我 们 很 少 直 接 使 用 它 。 


客户 端 需要 发 消息 给 服务 端的 话 ， 可 以 让 Subscription 调用 ， 然 后 通过 Consumer 
中 转 ， 最 后 才 由 Connection 进行 发 送 


Subscriptions 


Subscription 的 集结 地 ， 有 专门 的 @subscriptions 用 来 保存 subscription > # 
且 可 进行 管理 。 


常用 的 : 


create 


过 它 可 创建 Subscription 实例 。 


Bi 


H2 。 
vb. 


N 


d 


constructor 


add 

remove 
reject 
forget 
reload 
notify 


findAll 
notifyAll 


sendCommand 


还 有 各 种 方法 ， 针 对 具体 某 个 subscription 进行 各 种 操作 。 可 订阅 某 个 Channel > 
之 后 在 其 Channel 发 布 消息 时 ， 它 就 能 收 到 了 。 


通过 identifier 查找 具体 某 个 subscription. 


Connection Monitor 


轮 询 机 制 ， 通 过 浏览 器 自 带 特性 就 能 实现 ， 非 党 重要 的 “ 约 


配置 : 
QpollInterval: 
min: 3 
max: 30 


QstaleThreshold: 6 


常用 方法 如 : 


connected 
disconnected 


received 


>» 


Æ o 


identifier 
constructor 


reset 

start 

stop 

poll 
getInterval 


reconnectIfStale 


connectionIsStale 
disconnectedRecently 


visibilityDidChange 
now 
secondsSince 


clamp 


也 是 通过 "“ 死 循环 ”实现 的 。 
这 里 的 “ 死 循环 "是 有 间隔 、 有 状态 、 可 控 的 。 


一 些 重 要 的 东西 


ActionCable.server 


Rails 默认 使 用 的 实例 是 ActionCable.server 除了 Base 提供 的 实例 方法 外 ， 


它 还 可 调用 Broadcasting 和 Connections 提供 的 方法 。 


App.cable 


Rails 默认 使 用 App.cable 表示 其 Consumer 实例 。 


@App = {} 
App.cable = ActionCable.createConsumer ( ) 


术语 

server 服务 端 〈 死 的 ) 
connection 链接 本 身 ( 活 的 ) 
consumer 客户 端 〈 死 的 ) 


channels 链接 通道 ( 死 的 ) 


broadcastings 对 通道 的 某 些 操作 ( 活 的 ) 


流程 


1) A 输入 数据 ，jQuery 监测 ， 发 送 类 似 Ajax 请 求 ; 服务 器 收 到 ， 服 务 器 处 理 后 ， 
发 送 Ws 请 求 1) 或 由 服务 端 server.broadcast 直接 发 送 ws 请 求 


发 送 的 ws 请 求 ， 要 有 标识 及 数据 。 


2) 客户 端 始 终 在 等 待 ws 请 求 3) 客户 端 收 到 ws 请 求 ， 根 据 标识 由 对 应 的 


Channel js 处 理 


此 处 有 分 支 


4) 客户 端 直接 使 用 JQuery 处 理 ， 不 需要 再 请 求 服务 器 4) FP 39 @perform 发 送 
ws 请 求 ， 对 应 Channel rb 里 的 action 处 理 ， 再 响应 ...server broadcast 或 
Streams : 


结束 。 
重要 方法 : 客户 端 perform, 服务 端 broadcast 和 received. 


服务 端 、 客 户 端 均 可 发 送 Ws 请 求 ; 简单 的 只 有 一 次 ws 请 求 ， 复 杂 一 点 的 有 两 次 
ws 请 求 。 


Action Cable others 


命令 行 生 成 
创建 项 目 时 ， 已 经 默认 自动 生成 : cable.coffee、channel.rb 和 connection.rb. 


使 用 : 


rails generate channel NAME [method method] [options] 


生成 两 文件 : "name channel.rb" 和 "name.coffee" 


生成 的 .rb 文件 有 默认 方法 : subscribed 和 unsubscribed， 及 其 它 自 定 义 的 方 
法 。 

生成 的 .coffee 文件 有 默认 操作 : 链接 、 断 开 链 接 、 接 收 到 数据 ， 及 其 它 自 定 义 
操作 。 


依赖 
自身 : 


s.add dependency 'actionpack', version 


s.add dependency 'nio4r', >22. 
s.add_dependency 'websocket-driver', '-> 0.6.1' 


BAT redis 也 是 必须 的 ， 尽 量 这 里 没有 声明 。 


Engine 


实现 方式 是 : Engine 


websockets + threads 
own Server process 
not need to be a multi-threaded application server 


Rack socket 


Action View 72 #78 X 
&,4&"i& HB (n) fe" i8 2e (v)" > BP : Renderer & Rendering. 


每 次 都 要 指定 模板 文件 ， 并 且说 一 遍 泻 染 ， 不 麻烦 吗 ? 
因为 模板 文件 ， 都 在 同一 目录 下 ， 所 以 我 们 不 必 这 么 麻烦 。 引 进 Action View 的 子 
模块 Rendering 后 我 们 设置 默认 的 目录 即 可 ， 并 且 能 自动 帮 有 我 们 "说 一 遍 浑 染 "。 


分 为 4 大 块 : 泻 染 器 、 模 板 、 上 下 文 和 查找 模板 对 象 。( 以 下 只 是 粗略 的 分 类 ) 


1) RA 


Template Renderer 


模板 泻 染 器 


Streaming Template Renderer 
UB IS FS 


为 了 支持 "streaming 7" ! 


Renderer 


XML 演 染 器 


Partial lteration 
局 部 模板 迭代 


Partial Renderer 
局 部 模板 泻 染 器 


Abstract Renderer 
qu Rw RARE 


2) 1€ 3& (Template) 


对 应 文件 及 同名 目录 。 


3) ETF x(view context) 


Rendering 


泻 染 (动词 


Er view context 很 小 的 组 成 部 分 。 
Output Hew & Streaming Flew 

输出 流 

Output Buffer& Streaming Buffer 

输出 缓冲 区 

4) ERIMI (lookup context) 


View Paths 
视图 文件 所 在 目录 


PathSet 
路 径 集 ( 供 View Paths 使 用 ) 


DetailsKey 
类 似 cache key 


DetailsCache 
A Details 做 缓存 


Lookup Context 
查找 上 下 文 


Base - 438 #47 AH 


不 同 于 其 它 几 个 组 件 ， 对 外 提供 的 接口 是 Action View 模块 本 身 ， 而 不 是 
ActionView::Base & > 


module ActionView 
class Base 
attr accessor :view renderer 
attr internal :config, :assigns 


delegate :lookup context, :to -» :view renderer 
delegate :formats, :formats=, :locale, :locale=, :view paths 
, iview_paths=, 
:to -» :lookup context 


def initialize(context = nil, assigns = {}, controller = nil 
, formats - nil) 
Q config = ActiveSupport::InheritableOptions.new 


if context.is a?(ActionView::Renderer) 
Qview renderer - context 
else 
lookup context - context.is a?(ActionView::LookupContext 


) ? 
context : ActionView::LookupContext.new(context) 
lookup context.formats = formats if formats 
lookup context.prefixes - controller. prefixes if contro 
ller 
Qview renderer - ActionView::Renderer.new(lookup context 
) 
end 
assign(assigns) 
assign controller(controller) 
prepare context 
end 
end 
end 


因为 ， 类 和 对 象 的 概念 ， 对 于 视图 来 说 重要 性 没有 那么 大 。 


view context ActionView::Base 的 实例 对 象 。 


self.class.superclass 
-» ActionView::Base 


Class.new(ActionView::Base) do 
if routes 
include routes.url helpers(supports path) 
include routes.mounted helpers 
end 


if helpers 
include helpers 
end 
end 


在 ActionView::Rendering € ° 


怎么 传递 实例 变量 的 ? 


有 泻 染 才 有 传递 实例 变量 这 么 一 说 。 


4 action view/rendering.rb 
def view context 


view context class.new(view renderer, view assigns, self) 
end 


4 abstract controller/rendering.rb 
def view assigns 
# Rails B & 自己 管理 的 一 些 实例 变量 


protected vars = protected ivars 

# 此 方法 由 Ruby 提供 ， 通 过 它 我 们 可 获取 Controller 里 我 们 定义 的 一 些 实例 
variables = instance variables 

# 


end 


初始 化 View 的 时 候 ， 会 指派 实例 变量 : 


4 action view/base.rb 
def assign(new assigns) # :nodoc: 
@ assigns = new assigns.each { |key, value| instance variable 
set("@#{key}", value) } 
end 


3E Rails ©2149 32 & 8j 
先 看 例子 ， 然 后 看 看 非 Rails 是 如 何 浑 染 的 ， 需 要 哪 几 个 重要 元 素 。 


标准 库 ERB 举例 


require "erb" 


4 build data class 
class Listings 
PRODUCT = ( :name => "Chicken Fried Steak", 
:desc => "A well messages pattie, breaded and frie 


‘cost -> 9.95 } 
attr_reader :product, :price 
def initialize(product = "", price = "") 


Qproduct - product 
Qprice = price 


end 
def build 
b = binding 


4 create and run templates, filling member data variables 
ERB.new(««-'END PRODUCT'.gsub(/^Ns*/, ""), 0, "", "Qproduct" 
).result b 
<%= PRODUCT[:name] %> 
<%= PRODUCT[:desc] %> 
END_PRODUCT 
ERB.new(<<-'END_PRICE'.gsub(/4\s+/, ""), 0, "", "@price").re 
sult b 
<%= PRODUCT[:name] %> -- <%= PRODUCT[:cost] %> 
<%= PRODUCT[:desc] %> 
END_PRICE 
end 
end 


# setup template data 
listings = Listings.new 


listings.build 


puts listings.product + "\n" + listings.price 


输出 结果 


Chicken Fried Steak 
A well messages pattie, breaded and fried. 


Chicken Fried Steak -- 9.95 
A well messages pattie, breaded and fried. 


上 面 的 例子 ， 也 许 没 能 体现 环境 的 变化 ， 再 来 一 个 : 
require 'erb' 


# 准备 条 件 
class User 
attr accessor :name 


def initialize(name) 
name = name 
end 
end 


@user = User.new("Kelby") 


# 打包 环境 
binder = self.send(:binding) # 调用 :binding 私有 方法 


# 模板 
template = "Hello, <%= Quser.name %>" 


H RE (674) 
render = ERB.new(template) 
# ER(AM) 

render.result (binder ) 


# 输出 结果 


| 1 ER 


=> "Helo, Kelby" 


在 这 里 ， 重 要 元 素 有 : 泻 染 器 (名 词 ) 对 应 着 render ， 上 下 文 对 应 着 binder * 
浑 染 ( 动 词 ) 对 应 着 result. 


Rails 里 ， 对 应 的 有 : 泻 汪 器 (名 词 ) 对 应 着 render ， 上 下 文 对 应 着 

view context ， 泻 染 ( 动 词 ) 对 应 着 render . 

Rails 里 模板 文件 众多 ， 而 且 可 以 衣 套 使 用 ， 为 了 方便 查找 模板 内 容 ， 引 入 了 
lookup_context 的 概念 。 


Rails 使 用 的 是 Erubis 


Rails 用 的 是 gem 'erubis'， 不 是 Ruby 标准 库 里 的 ERB， 不 过 它们 原理 类 似 ， 不 再 
深入 。 

链接 

Binding 

ERB 

Erubis 


= 日 y> i 
Rails 是 如 何 浑 染 的 
别 忘 记 了 在 YourController#your_action 里 ， 除 了 有 render 方法 外 ， 还 有 N 多 
和 泻 染 相 关 的 方法 ! 有 它们 就 完全 可 以 做 泻 染 任务 了 。 


在 某 个 action 里 打 断 点 ， 然 后 : 


self.respond to? :render 


# => true 


self.respond_to? :lookup_context 
# => true 


self.respond_to? :view_renderer 
# =e Ue 


self.respond to? :view context 


# => true 


self.respond_to? :view_assigns 


# => true 


Note: 在 YourMailer#your_action 里 打 断 点 ， 结 果 一 样 。 


我 们 调用 的 是 render 方法 时 ， 它 会 调用 到 lookup context 和 
view renderer 


而 lookup context 可 以 帮 有 我 们 找到 要 浑 染 的 模板 。 
a RE + 模板 内 容 + 上 下 文 


view renderer.new(Qlookup context).render(context, options, bloc 
k) 


view renderer 指 的 是 泻 当 器， 也 就 是 : TemplateRenderer ` PartialRenderer 
或 StreamingTemplateRenderer. 


Qlookup context 用 来 查找 模板 的 。 


context 指 的 是 上 下 文 ， 对 应 上 面 的 view context . 


通过 self.view assigns 或 self.view context.assigns 可 以 查看 ， 我 们 
在 Controller 传递 给 View 的 实例 变量 (它们 只 是 上 下 文 内 容 里 的 一 部 分 )。 


Rendering 


承上启下 的 作用 : 


ActionController::Rendering 


| 
V 


AbstractController::Rendering 


| 
V 


ActionView::Rendering 


| 
V 


ActionView::Renderer 


Action Controller 和 Abstract Controller T £438 f] 3x Bia 4838 X 8] Zr iX © 
实例 方法 : 


view context 
view renderer 


render to body 
rendered format 


view context class 


view renderer X ActionView::Renderer 的 实例 对 象 。 

view context 是 ActionView::Base 的 实例 对 象 。 

render to body 上 面 几 个 方法 中 ， 惟 一 的 动词 ， 会 执行 泻 染 程序 。 
view context 使 用 举例 : 


通过 view_context 可 以 在 Controller 里 调用 Helper 里 的 方法 。 


Rendering 
举例 一 : 


module ApplicationHelper 
def fancy helper(str) 
str.titleize 
end 
end 


class MyController « ApplicationController 
def index 


@title = view context.fancy helper "dogs are awesome" 
end 
end 


举例 二 : 


4 app/controllers/posts controller.rb 
class PostsController « ActionController::Base 
def show 
# o... 
tags = view context.generate tags(Qpost) 
email link - view context.mail to(Quser.email) 


4 app/helpers/posts helper.rb 
module PostsHelper 
def generate tags(post) 
"Generate Tags" 
end 
end 


类 方法 : 


view context class 


# E > ActionController 和 AbstactController 有 同名 方法 ， 根 据 Ruby 的 继承 规 
则 ， 它 们 也 可 以 调用 这 里 的 方法 。 


当然 ， 还 有 其 它 方法 ， 但 不 在 此 列举 。 


浑 染 器 需要 有 上 下 文 和 模板 对 象 ， 才 能 顺利 的 工作 。 
(但 它 不 直接 和 模板 打交道 ? 谁 和 模板 打交道 ?) 
最 后 


ARTE Ria HAYA BW > render 还 有 不 少 的 可 选 参数 ， 比 
如 : :partial、:template、:inline、:file 和 :text， 使 用 的 时 候 需 要 根据 情况 挑选 使 
用 。 


Renderer - 2 #4) A ua 
RAT (CRAM > URGET RC ETUR EAM) 
render 或 render body 方法 加 上 它们 的 参数 ， 决 定 了 使 用 Template 


Renderer、Partial Renderer 还 是 Streaming Template Renderer. 


# Main render entry point shared by AV and AC. 
render(context, options) 


# Render but returns a valid Rack body. 
render_body(context, options) 


# 下 面 这 两 个 方法 ， 没 有 对 外 提供 的 接口 ， 不 要 直接 使 用 它们 | 


# Direct accessor to template rendering. 
render template(context, options) 


4 Direct access to partial rendering. 
render partial(context, options, &block) 


Note: 358] — T > Streaming Template Renderer 用 得 很 少 ， 本 说 明 后 文 不 再 重 


= 


A o 


X 3X Abstract Renderer 


具体 茶 个 浑 染 器 的 抽象 类 、 基 类 ， 定 义 了 接口 ， 并 提供 了 几 个 保护 方法 给 予 类 使 


目前 ， 只 有 347835 > Template Renderer ` Partial Renderer 和 Streaming 
Template Renderer. 


接口 : 
render 
保护 方法 : 


extract details 
prepend formats 


除 上 述 外 ， 还 有 : 


delegate :find template, :template exists?, :with fallbacks, :wi 
th layout format, 
:formats, :to => :Qlookup context 


7% Template Renderer 
普通 的 模板 泻 染 器 ， 直 接 继承 于 Abstract Renderer. 
用 到 了 template 里 的 东西 。 

要 考虑 layout. 


借助 了 (glookup context. 


T & Partial Renderer & Collection Caching 
局 部 模板 泻 染 器 ， 直 接 继承 于 Abstract Renderer. 
可 以 泻 染 一 个 集合 ， 此 时 借助 了 Partial Iteration. 


借助 了 (glookup context. 


子 类 Streaming Template Renderer 
流 模板 泻 染 器 ， 直 接 继承 于 Template Renderer， 间 接 继承 于 Abstract Renderer. 
重 写 了 父 类 的 render template 方法 。 


Streaming Template Renderer 用 得 很 少 ， 不 做 过 多 介绍 。 


Go 
Template A 
模板 对 象 的 内 容 ， 及 其 所 携带 的 信息 。 
ERBHandler = ActionView::Template::Handlers::ERB.new 


body = "<%= hello %>" 
details = { format: :html } 


def new_template(body = "<%= hello %>", details = { format: :html 
}) 
ActionView::Template.new(body, "hello template", 
details.fetch(:handler) ( ERBHandler 
ty 
{:virtual_path => "hello"}.merge! (det 
ails)) 
end 


@template = new_template 
@template = new template("«9— apostrophe %>") 
@template = new_template("<%= apostrophe %> <%== apostrophe %>", 
format: :text) 
@template = new_template("<%= hello %>", 
:handler => ActionView: : Template: :Handl 


ers: :Raw.new) 
EE 5 


当然 ， 这 些 我 们 平时 都 接触 不 到 ， 知 道 有 这 么 回 事 即 可 。 


attr accessor :locals, :formats, :variants, :virtual path 


attr reader :source, :identifier, :handler, :original encoding, 
:updated at 


# 看 看 新 建 模板 ， 要 求 是 什么 
def initialize(source, identifier, handler, details) 
if handler.respond to?(:default format)) 


format - details[:format] || (handler.default format 
end 
Qsource - source 
@identifier = identifier 
@handler = handler 
@compiled = false 
@original_encoding = nil 
@locals = details[:locals] || [] 
@virtual_path = details[:virtual_path] 
@updated_at = details[:updated_at] || Time.now 
@formats = Array(format).map { |f| f.respond_to?(:ref 
jme nep up 
Qvariants - [details[:variant]] 
Qcompile mutex - Mutex.new 
end 


p ——— M 


template 本 文件 下 的 内 容 


encode! 
inspect 
refresh 
render 


supports streaming? 
type 
这 里 的 render 会 调用 方法 ， 进 而 泻 业 对 应 的 模板 。 


attr accessor :locals, :formats, :variants, :virtual path 


attr reader :source, :identifier, :handler, :original encoding, 
:updated at 


template H x 


包含 了 : error ` handlers ` html ` resolver ` text ^ types =F ° 
其 中 handlers 又 包含 了 : builder ` erb ` raw 等 。 


其 中 ，Html 和 Text 这 两 个 类 为 模板 ( 较 简单 )，handlers 下 面 的 Builder、ERB 和 
Raw 3 个 类 也 是 模板 ( 较 复 杂 )。 


MERTZ > Renderer 其 实 也 没 做 什么 ， 处 理工 作 交 给 Template 进行 处 理 。 


Renderer( 最 外 层 的 接口 ) 


| 
V 


各 个 Renderer (F Ij] 4 3E ) 


| 
V 


Template( 最 底层 的 处 理 ) 


template/ 目录 里 的 各 个 handler » 2.4755 X £j Rails 环境 无 关 的 解析 、 演 染 工 作 。 


Template 
视图 文件 


Type 

类 型 (也 就 是 format) 
Text & HTML 

(什么 也 不 是 ) 


Resolver 
解析 器 


Path Resolver 
路 径 解 析 器 


File System Resolver 
文件 系统 解析 器 


Optimized File System Resolver 
优化 的 文件 系统 解析 器 


Fallback File System Resolver 
回溯 的 文件 系统 解析 器 


Error 
各 种 错误 


Handlers 
处 理 器 ， 包 括 : 


e Raw 
原生 的 处 理 器 
e Erubis 


Erubis 4b 3g Z5 


e ERB 
ERB tH% 


e Builder 
XML 2224 


Lookup Context 


包含 了 一 些 基本 信息 ， 用 于 查找 模板 。 
由 原来 的 Template::Lookup 更 改 而 来 ， 其 实名 字 叫 Lookup Template Context 反正 
更 合适 。 


lookup_context 内 容 


基本 信息 ， 包 括 以 下 7 项 内 容 : 


def initialize(view paths, details = {}, prefixes = []) 
cred ud = {}, 
@skip_default_locale = false 
@cache = true 
@prefixes = prefixes 
@rendered_format = nil 


self.view_paths = view_paths 
initialize_details(details) 
end 


@cache=true, 

@details= { ... }, 

Qdetails keyznil, 

Qprefixes-[], 

Qrendered formatznil, 

Qskip default locale=false, 

Qview paths- £Z«ActionView::PathSet:0x007ff7250a0feO0 ... 


在 ActionView::Base 里 有 : 


delegate :formats, :formats=, :locale, :locale=, :view paths, :v 
iew paths-, 
:to => :lookup context 


lookup context 举例 


查看 应 用 根 目录 下 文件 及 目录 : 


X ls 

Gemfile README.rdoc app blorgh config.ru lib public 
tmp 

Gemfile.lock Rakefile bin config db log test 
vendor 


创建 一 个 简单 的 lookup. context 


FIXTURE LOAD PATH = File.join(File.dirname(__ FILE ), '../fixtur 
es!) 


=> -AU SS 


require 'action view' 


m co UD 
# 仍然 只 包 念 T 项 内 容 

lookup context = ActionView::LookupContext.new(FIXTURE LOAD PATH 
; 0) 

=> #<ActionView: :LookupContext:0x007ff725058088 

@cache=true, 

@details= { ... }, 

@details_key=nil, 

@prefixes=[], 

@rendered_format=nil, 

@skip_default_locale=false, 

Qview paths- £Z«ActionView::PathSet:0x007ff7250a0feO0 ... 


BE III A> Qview paths 下 有 很 多 的 内 容 。 


实例 方法 


attr accessor :prefixes, :rendered format 
mattr accessor :fallbacks 

mattr accessor :registered details 
formats- 


skip default locale! 


locale 
locale- 


with layout format 


类 方法 


register detail 


ak 5| 3t € registered details € > #4 X default x #7 iX » 


: locale ^ formats ^ variants 4e handlers. 


register detail(:locale) ( ... } 

register detail(:formats) { ... } 
register detail(:variants) { ... } 
register detail(:handlers) { ... } 


View Paths 
实例 方法 : 


find & find template 
exists? & template exists? 


find all 
view paths- 


with fallbacks 


find 很 重要 的 方法 ， 用 来 查找 模板 (Template)。 


template exists? 使 用 举例 ， 在 视图 里 检查 局 部 模板 是 否 存在 : 


template exists?("form", "posts", true) 


Note: & #]-F [ActionView::ViewPaths] 3t & 833 3X > 


get 


clear 


details key 


disable cache 


view context 


ig Ha X BH EF X - ActionView::Base 的 实例 对 象 。 


view context #2 ActionView::Base 的 实例 对 象 。 
View context class 默认 就 是 ActionView::Base 


view. context 内 容 


BlogsController.new.view context 

=> #<#<Class:0x007ff084a6ba90>:0x007ff07b745518 
@_assigns={"_routes"=>nil}, 

@_config={}, 

Q controller- BlogsController:0x007ff084a6bba8 

Q request-nil, 

Q routes-nil, 

Qoutput bufferznil, 

Qview flow-Z«ActionView::OutputFlow:0x007ff07b757010 @content={ 
}>, 

Qview renderer- ActionView::Renderer:0x007ff07b745ccO 
@virtual_path=nil> 


1) view_context.controller 


@_controller= 

#<BlogsController :0x007ff084a6bba8 
@_action_has_layout=true, 

@_config={}, 

@_headers={"Content-Type'"=>"text/html"}, 

Q lookup context- ActionView: :LookupContext:0x007ff07b7474a8 
Q prefixes-["blogs", "application"], 

Q request-nil, 

@_response=nil, 

@_routes=nil, 

@_status=200, 
@_view_context_class=#<Class:0x007ff084a6ba90>, 

Q view renderer- ActionView::Renderer:0x007ff07b745ccO 


2) view context.view renderer 


Qview renderer- 
H«ActionView::Renderer:0x007ff07b745ccO 
Qlookup context- ActionView::LookupContext:0x007ff07b7474a8 


KAW controller context 


在 Controller 里 ， 除 了 实例 变量 ， 我 们 还 可 以 有 其 它 方法 传递 内 容 给 View ^ RAF 
式 类 似 。 


class BasicController < ActionController::Base 
#1) 只 引入 对 应 模块 
include ActionView::Context 


4 2) 调用 对 应 模块 里 的 方法 
before filter : prepare context 


def hello world 
@value = "Hello" 
end 


protected 
# 3) 更 改 view context 
# 默认 它 是 ActionView::Base 的 实例 对 象 
def view context # STEP 3 
self 
end 


4 在 View 里 可 以 调用 此 方法 
def — controller method . 
"controller context!" 
end 
end 


4 app/views/basic/hello world.html.erb 
<%= (value %> from <%= X controller method 9» 


因为 request/response 不 是 完整 的 ， 不 能 在 浏览 器 里 通过 url 访问 ， 使 用 以 下 命令 
NEN . 
验证 : 


curl http://dev.shixian.com:3000/hello world 


返回 : 


# app/views/basic/hello world.html.erb 
Hello from controller context! 


Note: 本 示例 仅 为 了 有 助 于 理解 view context 及 理解 Rails 是 如 何 泻 染 内 容 
的 ， 不 可 用 于 实际 项 目 。 


考 


Design Principles behind 


Context 
部 分 上 下 文 内 容 。 
从 Base 里 抽取 出 来 的 ， 提 供 了 @output_buffer, @view flow 和 @virtual_path 


为 了 Action Controller 可 以 创建 ActionView::Base 的 实例 对 象 ， 然 后 进行 演 染 模板 
的 工作 。 


不 要 被 名 字 欺 骗 了 ， 它 只 是 view context 很 小 的 组 成 部 分 。 


输出 流 
一 般 的 泻 染 器 用 的 是 "Output Flow" ; 


BAS ag ye Fe 


&$ 7<"Streaming Template Renderer" $4 114% > "Streaming Flow" 就 能 
派 上 用 场 了 。 


View Paths 
把 路 径 信息 放 到 PathSet » 2/2 #9 lookup context FZ 11 » 
类 方法 : 


append view path 
prepend view path 


view paths 
view paths- 


append view path(path) 追加 路 径 到 当前 Controller 所 在 的 view paths 里 。 


当 我 们 的 自己 创建 或 者 使 用 的 gem 引入 的 文件 目录 结构 和 Rails 默认 不 一 样 ， 但 且 
希望 浑 染 到 视图 里 的 模板 (局 部 模板 )， 就 会 报错 ， 此 方法 可 以 帮助 我 们 。 


prepend view path 和 append view path 方法 类 似 。 


实例 方法 : 


append view path 
prepend view path 


details for lookup 
lookup. context 
lookup context 之 前 已 经 介绍 过 ， 很 重要 的 一 个 方法 。 
He: 
delegate :template exists?, :view paths, :formats, :formats=, :1 


ocale, :locale=, 
:to => :lookup context 


ix 09 A > RRA abstract controller/rendering.rb 文件 里 的 ， 后 来 单独 成 
view_paths.rb， 再 后 来 从 Abstract Controller 移 到 Action View. 


Note: 区 别 于 【ActionView::LookupContext::ViewPaths】 对 应 的 模块 。 


x 


/一 > 


7. 65 


TODO 


Output Buffer & Streaming Buffer 


普通 字符 串 使 用 html_safe 后 就 变 成 了 Safe Buffer 的 实例 对 象 。 


Output Buffer 继承 于 Safe Buffer， 它 封装 了 一 些 方法 ，Rails 视图 里 使 用 的 就 是 


m 


I o 


html safe? 和 Safe Buffer 并 不 是 一 对 一 关系 ， 所 以 会 出 现 Safe Buffer 实例 对 
象 的 html safe? 为 false 的 情况 (这 同样 影响 了 子 类 Output Buffer); 并 且 视 图 里 字 
符 串 拼接 (concat) 对 性 能 也 会 有 影响 。 


基于 种 种 原因 ， 和 Output Buffer 相对 的 引入 了 Streaming Buffer， 但 它 以 ' 流 ' 的 形 
式 传 递 数据 到 客户 端 ， 并 且 它 不 继承 于 Safe Buffer， 所 以 绕 开 了 一 些 问题 。 

举例 : 

使 用 "Capture Helper" ° 4/4] 2]"Output Buffer" ; 

而 使 用 "Streaming Template Renderer" > 1 2/4] 2]"Streaming Buffer" » 

参考 


YAGNI methods slow us down 
ActionView Safe Buffer 


= = 日 ^ x 2 

Action View 提供 的 辅助 方法 

下 面 helper 分 类 ， 只 是 为 了 方便 理 清 它们 的 结构 。 实 际 过 程 中 ， 可 交叉 使 用 ， 能 达 
到 目的 即 可 ， 并 且 直 接 写 HTML 也 是 允许 的 。 

有 的 方法 根据 其 参数 ， 可 归于 多 个 分 类 。 如 : 表单 元 素 和 通用 元 素 ( 非 表单 元 素 )。 


因为 Rails 背后 会 把 所 有 helper 方法 (函数 ) 都 会 被 放 进 同一 个 module 里 ， 所 以 它 
们 之 间 互 相 调 用 。 


与 表单 直接 相关 的 辅助 方法 
按照 代码 结构 上 , 可 分 为 四 类 : 


e Form Builder 

e Form Helper 

e Form Options Helper 
e Form Tag Helper 


按照 使 用 方式 不 同 ， 又 可 分 为 三 类 : 


e Form Builder 对 Model 依赖 最 重 ， 表 单 对 象 几 乎 等 价 于 record 对 象 。 

e Form Helper 和 Form Options Helper 次 之 。 

e Form Tag Helper 对 Model 依赖 最 轻 ， 没 有 表单 对 象 的 概念 ， 操 作 上 几乎 等 价 
T HTML (其 实 就 是 语法 糖 ) 。 


Form Builder 和 Form Helper 在 方法 、 函 数 上 基本 是 对 应 的 。 


Form Builder 是 面向 对 象 ，Form Helper 是 面向 函数 。 


Form Builder 


Form Builder 是 面向 对 象 。 


你 要 修改 的 是 record 对 象 ， 途 径 是 通过 表单 实现 。 所 以 ，record 对 象 和 表单 就 必 
需 有 某 种 联系 。 在 这 里 ， 这 种 联系 由 Form Builder 及 其 实例 对 象 完成 。 


源 代 码 里 ， 有 3 个 来 源 : 
date helper.rb 


form helper.rb 
form options helper.rb 


大 部 分 是 封装 @template 
大 部 分 以 了 XXX 的 形式 调用 。 


Note: f 就 是 FormBuilder 的 实例 对 象 ， 所 以 可 以 调用 FormBuilder 的 实例 方 


# form for Æ fields for 745] instantiate builder 
# 再 调用 
default form builder 
builder - ActionView::Base.default form builder 
end 
ActiveSupport.on load(:action view) do 
cattr accessor(:default form builder) { ::ActionView::Helpers: 
:FormBuilder } 
end 


4 简单 理解 builder = FormBuilder 


# 最 后 调用 


builder.new(object name, object, self, options) 


+ R T £.xxx 调用 。 


button 

check box 
collection check boxes 
collection radio buttons 


collection select 


date select 
datetime select 


fields for 


file field 


grouped collection select 


hidden field 


label 


radio button 


select 


submit 


time select 
time zone select 


扩展 Form Builder 


使 用 : 


<%= form for @person do |f| 96» 
Name: <%= f.text field :name %> 
Admin: <%= f.check box :admin %> 

«96 end %> 


这 里 的 f X Form Builder 的 实例 对 象 ， 所 以 可 以 直接 调用 FormBuilder 提供 的 
方法 。 


扩展 : 


你 可 以 继承 于 Form Builder ， 然 后 构建 和 表单 相关 的 helper 方法 ， 举 例 : 


class MyFormBuilder < ActionView::Helpers::FormBuilder 
def div radio button(method, tag value, options = {}) 
Qtemplate.content tag(:div, 
Qtemplate.radio button( 
Qobject name, method, tag value, objectify options(optio 


<%= form for @person, :builder => MyFormBuilder do |f| %> 
I am a child: <%= f.div radio button(:admin, "child") 95» 
I am an adult: <%= f.div radio button(:admin, "adult") 96» 
<% end -%> 


Form Helper 
Form Helper 是 面向 函数 。 


相对 与 Form Builder 它 更 灵活 ， 因 为 它 没 有 限定 对 象 。 有 时 候 我 们 ' 需 要 ' 这 样 做 ， 
而 有 时 候 我 们 没 ' 必 要 '。 


大 部 分 封装 Tags::Xxx 
名 字 Form Helper 起 得 有 一 点 不 合适 。 


部 分 方法 需要 的 参数 "object name" > 3-754148 record 对 象 ， 也 可 以 是 非 record 
xt Ho 


check box 
color field 


date field 


datetime field 


datetime local field 


email field 


fields for 


form for 


label 


file field 


hidden field 


month field 


number field 


password field 
phone field 


radio button 
range field 


search field 
telephone field 
text area 

text field 

time field 


url field 


week field 


form for 和 fields for 是 另类 ， 它 们 都 可 用 于 构建 表单 : 


form for 和 record 对 象 关联 比较 大 。 
fields for 区 别 于 form for， 与 record 对 象 直接 关联 不 大 。 


Form Options Helper 
多 用 于 处 理 集合 。 
常见 于 两 个 对 象 之 间 。 
分 为 目的 和 手段 。 
比如 : select tag 是 目的 ，options for select 是 手段 。 
名 字 Form Options Helper 起 得 有 一 点 不 合适 。 
部 分 方法 需要 传递 参数 "object"， 并 不 特 指 record 对 象 ， 可 以 是 非 record 3% > 
最 常用 的 几 个 方法 
关键 词 : select 
select 


collection select 


i| : optgroup 


grouped collection select 


fa time zone 


time zone select 


关键 词 : option 
options for select 


options from collection for select 


相对 而 言 ， 几 个 不 太 常 用 的 方法 


关键 词 : option 


ae time zone 


time zone options for select 


关键 词 : optgroup 


grouped options for select 


option groups from collection for select 


关键 词 : checkbox 


collection check boxes 


关键 词 : radio 


collection radio buttons 


Form Tag Helper 

最 接近 HTML 代码 > 

没有 对 象 ( 不 用 对 应 model) 及 相关 概念 。 
封装 tag 或 content tag 而 来 。 


名 字 Form Tag Helper 起 得 非常 不 合适 。 

这 里 的 方法 与 表单 及 record 对 象 都 没有 直接 相关 ， 它 只 用 于 生成 HTML 代码 。 也 
就 是 说 它们 并 不 依赖 于 表单 元 素 和 record 对 象 。 把 它们 放 到 此 章节 ， 完 全 是 因为 它 
们 所 在 的 模块 名 字 带 "Form". 


button 标签 


button tag 


input 标签 
check box tag 
color field tag 
date field tag 
time field tag 
datetime field tag 
datetime local field tag 
email field tag 
file field tag 
hidden field tag 


image submit tag 


month field tag 


number field tag 


password field tag 


phone field tag & telephone field tag 


radio button tag 


range field tag 


search field tag 


submit tag 


text field tag 


url field tag 


utf8 enforcer tag 


week field tag 


fieldset 标签 


field_set_tag 


label 标签 


label_tag 


select 标签 


select_tag 


textarea 标签 


text area tag 


form 标签 


form tag 


上 面 并 不 是 表单 可 以 使 用 的 所 有 方法 ， 有 一 些 是 动态 定义 的 。 


default form builder = ::ActionView::Helpers::FormBuilder 
builder - default form builder 


object name - 'product' 
object - nil 
options = (3 


f = builder.new(object name, object, self, options) 

=> #<ActionView: :Helpers: :FormBuilder :0x007feaa896bc80 
@default_options={}, 

@index=nil, 

@multipart=nil, 

@nested_child_index={}, 

@object=nil, 

@object_name="product", 

@options={}, 

@template=main> 


与 表单 非 直接 相关 的 辅助 方法 
Rails 提供 了 很 多 的 helper 供 我 们 使 用 ， 处 理 asset ^ date ^ form ^ number 和 
record 对 象 等 。 黑 认 它 们 可 以 在 所 有 模板 上 使 用 。 


基于 Tag 实现 的 helper, 部 分 可 以 到 action. view/helpers/tags 目录 下 找到 相应 文 
> 25% render 方法 里 面 有 常用 的 可 选 参数 。 


对 设置 默认 值 等 ， 特 别 有 帮 助 。 不 用 写 html， 也 不 用 额外 添加 变量 。 
当 和 record 对 象 没 有 关联 时 ， 尽 量 使 用 x tag 的 形式 。 
区 别 于 表单 元 素 ， 这 里 的 helper 不 用 束 张 于 表单 ， 比 较 通用 。 


另 ， 表 单元 素 其 实 也 可 以 脱离 表单 来 使 有 用。 所以， 上面 有 提 到 FormXxx 模块 名 起 
得 不 太 合 适 (我 又 嘿 咏 了 )。 


Tag Helper 
几乎 所 有 生成 HTML 元 素 的 helper 方法 ， 都 封装 它们 而 来 。 
content tag 


tag 


content tag 用 于 生成 一 个 闭合 的 HTML 标签 。 很 多 helper 方法 ， 都 是 封装 于 


o 


je 
tag 用 于 生成 一 个 打开 的 HTML 标签 。 很 多 helper 方法 ， 都 是 封装 于 它 。 


cdata section 


escape once 


Url Helper 


可 直接 转化 成 HTML : 


link to 
button to 
mail to 


涉及 逻辑 判断 的 方法 : 
link to if 
link to unless 


link to unless current 


current page? 


Asset Tag Helper 


得 到 的 是 包含 asset 在 内 的 HTML 代码 。 


javascript include tag 
stylesheet link tag 


image tag 
image alt 


favicon link tag 
auto discovery link tag 


audio tag 
video tag 


Cache Helper 


cache 


cache if 
cache unless 


cache fragment name 


片段 缓存 和 Cache Key 


1) 页 


2) 页 


面 上 的 静态 内 容 


面 上 的 动态 内 容 


3) 页 面 上 的 内 容 ， 在 model 层面 有 关联 


4) 页 


面 上 的 内 容 有 嵌 套 关系 


使 用 片段 缓存 几 点 原则 


1. 


2. 


缓存 由 动态 内 容 和 静态 内 容 两 部 分 构成 。 
动态 内 容 的 cache key 由 我 们 指定 ; 
i 没有 谋 套 的 情况 下 ， 如 果 动 态 内 容 不 指定 cache_key， 则 自己 的 动态 内 容 
永远 不 会 更 新 (例外 见 最 后 ) ; 
i, ARAWHLT > wPRAAA BA cache_key， 则 自己 的 动态 内 容 & 
孩子 的 动态 内 容 永 远 不 会 更 新 (例外 见 最 后 ) ; 


. 没有 嵌 套 的 情况 下 ， 有 且 只 有 自己 的 cache key 更 新 ， 动 态 内 容 才 更 新 ; 


. 有 谋 套 的 情况 下 ， 有 且 只 有 自己 的 cache key 更 新 & 父亲 的 cache key 更 


新 ， 动 态 内 容 才 更 新 ; 


. 动态 内 容 的 更 新 ， 不 影响 静态 内 容 的 部 分 ; 


，( 各 动态 内 容 的 cache key 是 独立 的 ， 自 己 及 其 父亲 、 兄 弟 、 和 孩子 的 


cache key 没有 依赖 关系 ) 


. 无 论 哪 的 静态 内 容 更 改 ， 有 且 只 有 重启 后 更 新 ， 不 存在 (也 不 用 考虑 ) 谋 套 的 问 


A 


.静态 内 容 的 更 新 ， 不 影响 动态 内 容 的 部 分 (例外 见 最 后 ) ; 
. 例外 : 动态 内 容 没有 指定 cache key， 只 有 静态 内 容 同时 更 新 ， 并 且 重 启 ， 动 


态 内 容 才 会 更 新 。 


说 一 说 Cache Key 


1) record 的 cache key 


2) helper 方法 cache(name = {}, options = nil, &block) 这 里 的 name 
3) 内 存 数 据 库 key 

不 严格 区 分 的 话 ， 它 们 都 可 以 叫做 "Cache Key" 

但 ， 你 可 以 把 它们 区 分 开 来 : 


post.cache key 


# => "posts/1-20140921032815201680000" 


<% cache [ 'a post', post ] do %> 


<% end %> 


views/a post/posts/1-20140921032815201680000/9746fd05c8428f 79996 
81aa804071e9a 
(路 径 helper 方 法 cache 的 name 部 分 静态 内 容 md5 ) 


特点 : 


1 由 record 的 "id + updated_ at 时间 发" 组 成 ， 所 以 record 更 新 ，cache_key 会 更 新 
(update_column 等 情况 不 讨论 ) 


2 由 我 们 指定 ， 所 以 理论 上 可 以 随便 写 。 没 有 雍 套 缓存 的 情况 下 ， 一 般 可 以 直接 使 
A 1: ARAM LP TAR touch 更 新 父亲 资源 或 者 使 用 一 个 组 合 ， 如 : cache 
[current user, post] 


3 根据 2 生成 (但 不 等 于 2)， 要 求 唯一 (要 不 然 就 没 意 义 了 ) 
2 每 次 请 求 都 要 计算 


2 计算 之 后 和 3 对 比 是 否 匹 配 。 不 匹配 则 生成 新 的 内 容 ， 浑 染 页 面 ; 匹配 则 返回 ， 


2 不 匹配 ， 那 么 意味 着 之 前 的 内 容 过 期 了 ， 过 期 的 内 容 还 是 继续 存在 的 数据 库 里 
的 。( 这 里 的 过 期 不 等 于 被 删除 ) 


2 过 期 的 内 容 可 以 由 我 们 手动 删除 ， 如 : Rails.cache.clear ; 或 让 数据 库 自动 删 
除 ， 如 config.cache store = :redis store, 

'redis://localhost :6379/5/cache', ( expires in: 90.minutes ) % € X 
据 最 多 只 能 在 redis 里 保存 redis 每 隔 90 分 钟 ， 到 期 的 缓存 数据 会 被 删除 。( 这 里 
的 到 期 等 于 被 删除 ) 


LEER 


缓存 主要 有 两 种 方式 过 期 。 


1. 调用 cache(name = {}, options = nil, &block) 的 时 候 把 会 引起 数据 变化 的 元 素 
都 放 到 name 里 

2. 后 续 更 新 一 个 对 象 的 时 候 ，touch 其 关联 对 象 

e 嵌 套 太 深 不 适合 使 用 缓存 (不 超过 4 E) 

e 涉及 大 多 不 同类 型 的 record 对 象 时 ， 不 推荐 使 用 缓存 

e 弱 关 联 ( 非 has many, has one, belongs_to) 对 象 ， 不 适合 放 在 一 起 做 缓存 


BEKRA record 对 象 太 多 ,或 几 个 对 象 之 间 属 于 弱 关 联 ， 无 论 使 用 哪 种 缓存 过 期 
机 制 对 于 维护 都 是 恶 梦 。 


Controller Helper 


委托 Controller 方法 给 View 使 用 。 


delegate :params， :session, :cookies, :flash, 


'response, :headers, :action name, :controller name, :c 
ontroller path, 


:request forgery protection token, 
:to => :controller 


效果 和 使 用 helper method 类 似 。 


ActionView::Base initialize 时 就 会 引入 。( 其 实 ， 它 就 是 从 Base 里 抽取 出 来 的 ) 


Asset Url Helper 


仅 得 到 asset 所 在 的 路 径 。 


image path & path to image 


image url & url to image 


javascript path & path to javascript 


javascript url & url to javascript 


stylesheet path & path to stylesheet 


stylesheet url & url to stylesheet 


video path 
video url 


asset path 
asset url 


audio path 
audio url 


& 
& 


path to video 
url to video 


path to asset 
url to asset 


path to audio 
url to audio 


font path & path to font 
font url & url to font 


compute asset extname 


compute asset host 


compute asset path 


Csrf Helper 


csrf meta tag & csrf meta tags 


Capture Helper 


存储 代码 块 ， yield 调用 。 


content for 
content for? 


capture 


provide 


其 中 capture 和 content for 作用 类 似 ， 只 是 定义 和 调用 稍 有 不 同 。 


使 用 举例 : 


<% content for :navigation do %> 
<li><%= link to 'Home', action: 'index' %></li> 
<% end 96» 


<ul><%= yield :navigation %></ul> 


<ul><%= content for :navigation %></ul> 


Debug Helper 


debug 


使 用 gem 'pry-rails' 后 ， 很 少 有 使 用 这 个 方法 。 可 以 在 要 打 断 点 的 地 方 调用 
binding.pry 


或 者 ， 使 用 Rails 默认 使 用 的 debugger 打 断 点 。 


Date Helper 


date select 
datetime select 
time select 


distance of time in words 








time ago in words & distance of time in words to now 


select date 
select time 
select datetime 


select year 
select month 
select day 
select hour 
select minute 
select second 


time tag 


抽取 出 了 DateTime Selector， 用 来 处 理 这 里 和 select x 相关 的 方法 。 


JavaScript Helper 


j & escape javascript 


javascript tag 


Number Helper 


number to currency 
number to human 
number to human size 
number to percentage 
number to phone 


number with delimiter 
number with precision 


Output Safety Helper 


raw 


safe join 


Rendering Helper 
泻 染 : 调用 泻 染 器 进行 泻 染 工作 (这 里 全 部 是 调用 ， 并 且 主 要 是 泻 染 局 部 模板 ) 。 


render 


会 用 一 个 章节 详细 描述 其 相关 内 容 。 


Record-Tag-Helper 


content tag for 


div for 


增加 复杂 度 ， 还 不 如 直接 使 用 HTML # iA ERB 代码 。 


已 被 废除 。 


Sanitize Helper 


sanitize 
sanitize css 


strip links 
strip tags 


这 里 的 "消毒 "， 使 用 的 是 Rails Html Sanitizers 这 里 只 是 封装 ， 并 提供 接口 。 


Translation Helper 


t & translate 
1 & localize 


翻译 和 本 地 化 。 


Text Helper 


truncate 
concat 


cycle 
current cycle 
reset cycle 


excerpt 
highlight 
pluralize 


safe concat 
可 用 则 用 ; 否则 用 
simple format 
word wrap 


# 


+ 


# 


# 
# 


截取 茶 个 长 度 的 文本 
求 值 

循环 

循环 内 当前 值 


中 断 循 环 ， 从 头 开 始 


引用 、 摘 录 ( 只 显示 菜 个 词 及 其 附近 的 语句 ， 其 余 用 1... RË) 
高 亮 (默认 是 加 mark ) 


在 Active Support 里 也 提供 了 safe concat 方法 ， 如 果 
concat 


文本 简单 格式 化 
限制 长 度 


Atom Feed Helper 


不 同 于 其 它 信息 ，Atom 信息 不 能 用 ERB 或 其 它 模板 语言 创建 。 但 通过 这 个 方法 ， 
却 能 构建 Atom 订阅 信息 。 


atom feed 


抽取 出 了 Atom Feed Builder 和 Atom Builder， 用 来 处 理 这 方面 的 工作 。 


Active Model Instance Tag 
content tag 
error message 
error wrapping 
object 


tag 


HE 


在 model 里， 使 用 helper 方法 ? 
1) 直接 使 用 : 
OrdersController.helpers.order number(Qorder) 


ApplicationController.helpers.helper method 
ActionController::Base.helpers.sanitize(str) 


2) 4,5] A > FRA: 


include ActionView::Helpers::DateHelper 
include ActionView::Helpers 


方法 太 多 ， 看 不 过 来 ? 

有 的 Rails 内 置 方法 ， 难 懂 、 难 用 ， 所 以 可 以 不 用 。 以 Action View 举例 说 明 : 
我 们 需要 看 API， 才 知道 怎么 传递 参数 ， 有 什么 参数 ; 

直接 写 HTML， 大 脑 不 必 转 一 圈 ; 

前 端 工程 师 不 懂 Ruby， 就 看 不 懂 ; 

维护 的 时 候 也 遇 到 上 述 3 点 困境 。 


me B S oL 


Action View 其 它 类 和 模块 


下 面 这 些 方法 ， 和 泻 染 没有 直接 关联 ， 并 且 严格 意义 上 讲 不 属于 helper 方法 。 


Record Identifier 
根据 所 传递 的 对 象 ， 生 成 能 代表 其 身份 的 "字符 串 " o 


dom class 
dom id 


可 配合 其 它 helper 一 起 使 用 ， 使 用 举例 : 


dom class(post) # => "post" 
dom_class(Person) # => "person" 


# pn 
dom_class(post, :edit) # => "edit_post" 
dom_class(Person, :edit) # => "edit_person" 


dom id(Post.find(45)) # => "post 45" 

dom id(Post.new) 4 -» "new post" 

# 带 前 组 

dom id(Post.find(45), :edit) # => "edit post 45" 
dom id(Post.new, :custom) # => "custom post" 


实现 它们 时 直接 使 用 了 "字符 串 求 值 的 "方式 ， 并 且 用 到 了 ActiveModel::Model 里 的 
方法 。 


Note: 它 既 没有 对 应 也 没有 生成 HTML 标签 。 


Routing Url For 
url for 
它 生 成 的 内 容 是 url， 区别 于 link to 等 生成 的 是 链接 。 


可 选 参 数 的 类 型 可 以 是 : Hash ` String ` nil ` :back ` Array 等 ， 根 据 不 同 参 数 ， 可 
能 会 用 到 ActionDispatch::HelperMethodBuilder 里 的 东西 。 


Note: 有 多 个 url for 方法 ， 这 个 是 View 里 用 到 的 。 


Layouts 


layout 


布局 ， 影 响 泻 染 的 效果 ， 但 和 泻 染 没有 直接 关联 。 


4 String 

class InformationController « BankController 
layout "information" 

end 


# Symbol 

class VaultController « BankController 
layout :access level layout 

end 


# nil 

class CommentsController < ApplicationController 
# 始终 使 用 默认 的 layout (首先 是 comments’ /A/ 5X application #9) 
layout nil 

end 


4 false 

class TillController « BankController 
layout false 

end 


此 外 ， 还 有 可 选 参 数 :only 和 :except 
Note: 没有 layout true 这 种 写法 ， 会 报错 的 。 


layout 有 继承 关系 : 


Layouts 


class ApplicationController « ActionController::Base 
layout "application" 
end 


class PostsController « ApplicationController 


# JUKIS "application" layout 
end 


436 


Action View 里 有 Model Naming 模块 。 


Controller fe View 经 常 要 处 理 record 对 象 ， 比 如 得 到 单数 、 复 数 格 式 ， 得 到 
cache key ` route key ` param key 等 ， 这 都 需要 用 到 Model 里 的 方法 。 此 时 ， 
可 以 把 record 对 象 转 化 得 到 model _name， 然 后 再 进行 后 续 操作 。 


ActionController::ModelNaming 和 ActionView::ModelNaming 一 样 ， 都 提供 了 : 
convert to model 


model name from record or class 





方便 我 们 把 对 象 转换 成 Model 或 model name 进行 处 理 ， 但 一 般 我 们 不 会 直接 使 
用 o 


对 视图 进行 加 密 ， 是 片段 缓存 的 组 成 部 分 。 
类 方法 : 
digest 


tree 


Aal > Rails 里 有 两 个 地 方 调用 了 它 。 
1) Cache Helper 会 调用 。( 也 就 是 说 调用 cache helper 方法 时 ， 会 调用 到 它 ) 


2) Action Controller 里 的 Etag With Template Digest 也 会 调用 。( 可 配置 将 模板 
digest 的 结果 放 到 etaggers €) 


实例 方法 : 


digest 
dependencies 


nested dependencies 


dependencies 会 用 到 Dependency Tracker. 


Note: 有 类 方法 digest 和 同名 实例 方法 digest. 一 般 我 们 直接 调用 的 是 类 方法 ， 
也 就 是 ActionView::Digestor.digest， 之 后 它 内 部 处 理 ， 调 用 实例 方法 。 


Dependency-Tracker 


供 Digestor 使 用 ， digest 的 时 候 可 以 以 数组 的 形式 传 dependencies 作为 其 可 选 参 
数 。 


提供 类 方法 : 


register tracker 
remove tracker 


find dependencies 


以 数组 的 形式 返回 其 依赖 的 模板 (模板 、 局 部 模板 、 指 定 layout 的 模板 ) 的 名 字 : 


def dependencies 
render dependencies + explicit dependencies 
end 


一 个 action 模板 只 有 一 个 ， 所 以 主要 针对 的 是 里 面 所 包含 的 局 部 模板 。 


为 什么 有 的 helper 我 不 推荐 ? 
以 下 是 我 的 一 些 经 验 之 谈 ， 仅 供 参 考 。 


e 基于 其 它 helper， 并 且 功 能 上 十 分 类 似 ; 

e 使 用 它 ， 写 出 来 的 代码 反而 很 卫 陋 ; 

e 和 样式 关联 密切 ， 或 者 CSS、JS 也 能 做 的 ; 
e 不 实用 、 或 者 说 不 通用 


不 要 迷信 Rails 提供 的 helper， 有 的 用 起 来 难 读 、 难 懂 ， 还 不 如 自己 写 。 别 忘 了 ， 
设计 软件 的 重点 : 好 读 、 易 维护 、 以 全 局 观 思考 。 


Active Model 


我 们 知道 MVC 结构 里 ，Model( 模 型 ) 层 与 数据 库 关 系 最 紧密 。 现 在 我 们 是 把 
Model( 模 型 层 ) 再 拆 分 一 下 ， 把 对 数据 库 丨 正 有 操作 的 这 部 分 拆 分 成 Active 
Record， 把 没有 对 数据 库 操作 的 这 部 分 拆 分 成 Active Model. 


做 了 这 样 的 折 分 之 后 ， 如 果 我 们 觉得 Active Record 不 合 口 味 (例如 : 想 使 用 
NoSQL)， 但 又 不 想 完全 抛弃 它 。 解 决 方案 来 了 ， 使 用 Action Model > Active Model 
可 以 以 接口 的 形式 提供 一 系列 方法 给 model 使 用 。 


Active Record 对 于 需要 持久 化 的 数据 进行 校 验 或 处 理 ， 是 很 强大 的 。 但 如 果 我 们 
不 需要 持久 化 数据 ， 或 者 我 们 只 需要 很 少 的 功能 ， 如 : 提交 表单 数据 在 Web 开发 
中 是 比较 常见 (联系 我 们 ， 给 我 们 发 送 反 馈 意见 ) - 用 户 提交 信息 ， 无 论 校 验 是 有 效 
还 是 无 效 ， 都 应 该 得 到 反馈 。Active Record 太 重 了 ， 使 用 Active Model 可 以 帮助 
我 们 减少 复杂 度 。 


Note: 说 明 一 下 ，Active Model 脱胎 于 Active Record， 它 可 以 单独 使 用 ; 反 过 
来 ，Active Record 依赖 于 Active Model， 不 可 以 单独 使 用 。 


Model - 核心 


这 里 指 的 是 ActiveModel:: Model * ER È TEA & #49 Validations ` Conversion 
和 Naming ^ Translation 等 模块 是 整个 Active Model 里 的 核心 部 分 。 


Model 做 的 事情 包括 但 不 限于 : 校 验 和 抽象 ORM 接口 。 


Conversion & Validations 是 include 如 果 没 有 指明 ClassMethods， 则 引入 的 是 
实例 方法 ; 

Naming & Translation 是 extend 默认 引入 的 就 已 经 是 类 方法 。 注意 这 点 小 差 
别 ， 对 于 使 用 上 会 有 帮助 。 


Validations 


在 数据 存 入 数据 库存 之 前 ， 有 多 个 层面 可 以 对 数据 做 校 验 。 和 包括 客户 端 校 验 、 
Controller 级 别 的 校 验 、Model 级 别 的 校 验 和 数据 库 本 身 做 约束 。 它 们 各 有 利 头 ， 
在 此 不 做 讨论 。 


这 里 要 讲 的 是 Model 级 别 的 校 验 。 


类 方法 

常用 : 
validate # 调用 方式 一 (不 需要 属性 ， 也 不 需要 校 验 器 ; 直接 做 
校 验 ) 
validates 和 validates! # 调用 方式 二 (需要 属性 ， BERE ; 间接 做 校 验 ) 
validates each # 调用 方式 三 (需要 属性 ， 不 需要 校 验 器 ; 直接 做 校 验 ) 
validates with # 调用 方式 四 (不 需要 属性 ， 需 要 校 验 器 ; 作用 于 所 有 


对 象 ， 间 接 做 校 验 ) 
| 


除 上 述 方 法 外 ， 还 有 : 


validators 4 查看 所 有 可 用 的 校 验 器 
validators on(*attributes) # 查看 在 某 属 性 上 使 用 了 哪些 校 验 器 


clear validators! # 清除 校 验 器 


VAR: 


attribute_method?(attribute) 


attribute method? 放 在 这 里 有 点 不 太 合 适 ， 它 和 校 验 没有 多 大 关系 。 和 
Attribute Methods 反而 关系 比较 大 。 


经 验 : 牢记 validate REE save 之前， 如果 你 喜欢 用 before save 
的 进行 检验 ， 记 得 加 上 return false 或 者 改变 习惯 ， 用 validate 
:validate method 类 似 写 法 进行 校 验 。 


9 个 Helper Methods 


9 个 校 验 方法 ， 语 法 糖 。 调 用 方式 五 (不 需要 属性 ， 需 要 校 验 器 ; 作用 于 茶 个 


对 象 ， 间 接 做 校 验 ) 


validates format_of 

validates length of & validates size of 
validates absence of 

validates presence of 

validates exclusion of 

validates inclusion of 

validates acceptance of 

validates confirmation of 

validates numericality of 


由 于 它们 封装 validates with 而 来 ， 既 可 当做 类 方法 进行 调用 。 


之 类 


具体 


又 由 于 它们 具体 实现 时 继承 于 EachValidator， 又 可 以 当做 validates 的 参数 使 


用 o 


validates confirmation of 会 为 要 校 验 的 属性 生成 对 应 的 读 、 写 方法 
(x confirmation ` x_confirmation=) 


如 : 校 验 password * 4 /£;X password confirmation 读 方法 和 
password confirmationz 写 方法 。 


实例 方法 
errors 


invalid? 
valid? & validate 


validates with 


valid? 校 验 是 否 通 过 ， 只 有 一 个 判断 规则 : 当前 record 3t #4 errors 45 65 7 


= errors.empty? 


所 以 自己 写 校 验方 法 或 者 校 验 器 


Rails 5 € valid? 和 invalid? 可 加 类 似 [:create, :update] 
参数 进行 多 个 上 下 文 进行 校 验 。 


调用 方式 比较 
validate 
属性 不 需要 


validates 
和 


validates! 


间接 


的 时 候 ， 请 记得 设置 errors 的 值 。 


这 样 的 


validate: 


validates each . validates with 


需要 不 需要 
不 需要 需要 
直接 间接 


Note: 为 了 降低 理解 难度 validates each 用 到 的 BlockValidator 不 算 为 校 验 


ya. 
pau 
ed ? 


validates presence of 代表 着 其 它 与 之 类 似 的 方法 。 


上 面 说 的 都 是 类 级 别 的 校 验 ， 如 果 需 要 针对 某 个 实例 对 象 单 独 做 额外 的 校 验 ， 可 以 
使 用 实例 方法 validates_with， 参 数 和 同名 类 方法 一 样 。 


使 用 validate 


之 前 版 本 可 以 在 before save 等 方法 里 ， 设 置 record.errors.add :xxx 然后 
return false 做 校 验 ， 中 断后 续 操 作 。 


Rails 5 之 后 默认 关 掉 了 这 个 功能 ， 即 不 会 中 断后 续 操 作 。 推 荐 使 用 validate 


:method name 在 


method name 


写 对 应 校 验 代码 。 


Validator 


校 验 可 以 简单 分 为 3 个 层次 : 1) 完全 使 用 原生 的 ; 2) 使 用 原生 的 + 带 条 件 判断 ， 
或 自行 设置 errors ; 3) a 


自 定义 校 验 器 ， 有 两 种 方式 : 继承 于 Validator 3i EachValidator. 


继承 于 Validator 


ce 器 在 整个 项 目 生命 周期 中 只 初始 化 一 次 。 它 针对 的 是 整个 对 象 ， 并 且 自 动 执 
这 种 方式 ， 由 validates with 加 校 验 器 名 字 的 方式 进行 调用 。 


任何 继承 于 ActiveModel::Validator 的 校 验 器 都 要 实现 validate 方法 ， 此 方法 接 
a recaia 做 为 参数 。 然 后 ， 通 过 validates with 方法 可 以 使 用 刚才 
定义 的 校 验 验 35 


class MyValidator < ActiveModel: :Validator 
# 继承 于 Validator， 需 要 实现 validate 
def validate(record) 
record # => The person instance being validated 
options £ -» Any non-standard options passed to validates wi 
th 
end 
end 


class Person 
include ActiveModel::Validations 


# 调用 方式 


validates with MyValidator 
end 


继承 于 EachValidator 


实际 上 ， 推 荐 使 用 这 种 方式 。 这 种 方式 ， 由 validates 以 参数 的 方式 进行 调 
用 e 


任何 继承 于 ActiveModel::EachValidator 的 校 验 器 都 要 实现 validate each 7 
法 ， 此 方法 接收 要 校 验 的 record ` attribute ` value 做 为 参数 。 


class TitleValidator < ActiveModel::EachValidator 
4 继承 于 EachValidator’ #2 validate each 
def validate each(record, attribute, value) 
record.errors.add attribute, 'must be Mr., or Mrs.' unless % 
w(Mr. Mrs.).include?(value) 
end 
end 


然后 ， 通 过 validates 方法 (刚才 定义 的 校 验 器 做 为 参数 之 一 ) 可 以 使 用 刚才 定义 
的 校 验 。 


class Person 
include ActiveModel::Validations 
attr accessor :name 


# 调用 方式 
validates :name, title: true 
end 


语法 糖 : 


ActiveRecord::Base.class eval do 
def self.validates date of(*attr names) 
validates with TitleValidator, merge attributes(attr names) 
end 
end 


class Person « ActiveRecord::Base 
# 


# 调用 方式 
validates title of :name 
end 


Validator 


Note: EachValidator 也 继承 于 Validator. 
但 Rails 所 有 所 有 对 外 提供 的 校 验 器 ， 都 继承 于 EachValidator. 
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Errors 
有 校 验 就 会 有 失败 ， 对 属性 校 验 失败 时 的 报错 ， 是 它 的 实例 。 


record.errors.class 
=> ActiveModel::Errors 


自己 写 校 验方 法 或 者 校 验 器 的 时 候 ， 请 务必 设置 errors 的 值 ， 并 且 不 通过 进 返回 
false. 


常用 以 下 方法 : 
方法 解释 
[] AN get > AN set 
add 追加 错误 信息 到 属性 ， 但 在 这 之 前 做 了 一 点 格式 化 
keys 返回 所 有 错误 的 key 
values 返回 所 有 错误 的 value 
each 可 以 循环 获取 每 一 个 错误 的 key 和 value 


返回 所 有 的 错误 。 但 已 经 用 full message 对 它们 进行 了 格式 


full messages A> FAB GE 


? et OM" za T sd 
blank? a errors 这 个 对 象 是 否 为 室 ， 也 就 是 说 是 否 有 错误 
empty? 
details 查看 errors 详情 


除 以 上 外 ， 还 有 方法 : 


added? 


size 
count 


clear 
delete 


has key? & include? 
to a 

to hash 

to xml 


as json 


full message 
full messages for 


initialize dup 


generate message 


<%= Qrecord.errors.full messages.join(";") 9 


<%= Qrecord.errors.full messages.first 9» 


<% if Qrecord.errors[:title].present? %> 
<%= Qrecord.errors[:title].join('') %> 
<% end %> 


自己 定义 的 校 验 举例 : 


Errors 


# 校 验 开始 工作 日 期 不 能 早 于 今天 
before save :validates of beginning work date 


def validates of beginning work date 
if self.beginning work date changed? && (self.beginning work d 
ate « Time.now.beginning of day) 
# errors 不 为 室 ， 做 提醒 。 回 调 返回 false 就 不 能 保存 。 
self.errors.add :beginning work date, ' 不 能 小 于 当前 时 间 ， 
return false 





end 
end 


# 注意 在 local £2 beginning work date 进行 翻译 ， 以 便 更 友好 的 显示 报错 


信息 。 


Note: 因为 include Enumerable， 所 以 可 以 看 出 很 多 与 其 同名 的 方法 。 
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Validations 相关 的 Callbacks 


在 执行 校 验 之 前 、 之 后 做 茶 事 。 


提供 before validation ^ after validation 这 两 个 和 校 验 有 关 的 回调 方 
法 。 


class MyModel 
include ActiveModel::Validations::Callbacks 


before validation :do stuff before validation 
after validation :do stuff after validation 


def do stuff before validation 
end 
def do stuff after validation 


end 
end 


内 部 实现 ， 调 用 了 Active Support 提供 的 回调 相关 方法 ; 使 用 上 ， 和 Active 
Record 里 的 回调 方法 类 似 。 


Conversion 


数据 库 提 供 的 record 并 不 是 所 有 数据 对 我 们 都 有 用 ， 有 时 候 我 们 需要 转换 。 常 见 的 
转换 方法 有 : 

to key 

to model 


to param 


to partial path 


举例 to param 使 用 到 它 的 一 些 方 法 : 
url for 


button to 


此 时 ， 会 用 id 做 为 url 的 一 部 分 ， 这 对 用 户 体验 和 SEO 都 不 太 友好 ， 通 常 我 们 可 
以 在 model 里 履 盖 此 方法 。 


def to param 
"#{id}-#{title.parameterize}" 
end 


Naming & Name 


内 省 机 制 ， 主 要 负责 将 对 象 转换 成 对 应 的 字符 串 。 对 于 我 们 Web 开发 者 来 说 不 常 
用 ， 但 对 于 配合 Action Controller, Action View 工作 很 重要 。 


实例 方法 : 


model name 


类 方法 (调用 方式 奇怪 ， 一 般 我 们 不 会 使 用 ) : 
param key 
route key 
singular route key 
singular 


plural 
uncountable? # 


方便 我 们 把 ， 字 符 串 、 符 号 、 实 例 对 象 等 转换 成 相关 model 进行 处 理 。 


model name 返回 的 是 Name 的 实例 对 象 。Name 和 普通 字符 串 类 似 ， 但 提供 方 


和 
attr reader :singular, :plural, :element, :collection, 
:singular route key, :route key, :param key, :i18n key, 


: name 


alias_method :cache_key, :collection 


可 将 字符 囊 转换 成 对 用 户 更 友好 的 形式 展现 。 


model name 把 "各 种 对 象 " 转 换 成 对 应 的 "字符 串 "， 而 View 要 的 正 是 "字符 串 "。 
比如 以 下 几 个 方法 : 


Action View 
form for 


button 
submit 


fields for 


dom id 
dom class 


Action Controller 


wrap. parameters 


Action Dispatch 


polymorphic url 
polymorphic path 


相关 ActionController::ModelNaming 和 ActionView::ModelNaming. 


Note: 调用 此 模块 的 方式 是 extend ActiveModel:: Naming > Rx include ; 另外 
注意 实例 方法 与 类 方法 的 调用 方式 是 不 一 样 的 。 


human attribute name 


根据 属性 名 ， 自 动 转 换 成 对 人 类 阅读 更 加 友好 的 字符 串 。 如 "first name" 转换 成 
"First name". 


使 用 场景 非常 非常 有 限 。 举 例 : View 根据 字段 ， 自 动 生成 的 内 容 ; 格式 良好 的 
Errors 报错 信息 等 。 


lookup ancestors H respond_to?(:model_name) => true 的 祖先 。 


Note: 这 里 的 方法 用 得 很 少 ， 并 且 第 一 个 方法 里 的 "属性 名 "， 其 实 不 是 属性 也 可 
yA o 


Lint Tests 


前 面 提 到 Active Model 最 重要 的 是 Model. 想 要 去 掉 Active Record > 4$ f X- È 
ORM， 基 本 的 兼容 性 是 要 做 的 。 如 何 检测 基本 的 兼容 性 做 到 了 ?通过 Lint:Tests 可 
以 检测 即 可 。 


它 主要 测试 一 些 " 必 不 可 少 " 的 基本 方法 . 


test_errors_aref 
test model naming 


test to key 
test to param 


test to partial path 


test persisted? 


Model 的 增强 模块 


TODO 


Attribute Assignment 


以 Hash HUABEAH RM? 并且 传递 的 属性 经 过 
ForbiddenAttributesProtection 检查 。 


assign attributes 


Æ update & update attributes 的 底层 实现 。 参 数 的 类 型 都 是 Hash 对 象 ， 但 它 不 
会 触发 save 操作 。 


使 用 举例 : 


# 直接 赋值 
cat = Cat.new(name: "Gorby", status: "yawning") 
cat.attributes # => { "name" => "Gorby", "status" => "yawning", 
"created_at" => nil, 
"updated_at" => nil} 


# 使 用 Attribute Assignment 
cat.assign attributes(status: "sleeping") 
cat.attributes # => { "name" => "Gorby", "status" => "sleeping", 
"created at" => nil, 
"updated at" => nil } 


原理 上 它 和 直接 赋值 是 一 样 的 (用 了 元 编程 一 个 个 属性 直接 赋值 ) ， 只 是 对 于 要 传 
递 的 参数 多 了 ForbiddenAttributesProtection 检查 。 


对 比 直 接 赋 值 : 


user.is admin = true 
4 直接 赋值 ， 不 涉及 ForbiddenAttributesProtection 


user.assign attributes is admin: true 
4 ActiveModel::MassAssignmentSecurity::Error: 
4 Can't mass-assign protected attributes: is admin 


我 们 几乎 不 会 直接 使 用 assign attributes 给 对 象 赋值 。 


Attribute Methods 


Attribute Methods 可 以 很 方便 给 现 有 属性 (可 以 是 虚拟 属性 ) 添 加 前 级 、 后 级 或 前 级 
+ 后 级 ， 然 后 得 到 新 的 方法 。 


使 用 步骤 


1. include ActiveModel::AttributeMethods 

2. 调用 attribute method prefix 添加 前 级 ， 调 用 
attribute method suffix 添加 后 级 ， 调 用 attribute method affix 
添加 前 级 + 后 级 

3. 在 这 之 后 ， 调 用 define attribute methods ， 指 明 对 哪些 属性 有 效 ( 默 认 
是 所 有 ) 

4. 定义 一 个 attributes 方法 。 返 回 值 是 一 个 hash， 属 性 的 名 字 做 为 key’ % 
性 的 值 做 为 value. 实际 上 可 实现 其 读 、 写 方法 ， 相 当 于 attr_accessor 

5. 用 attribute 加 上 刚才 的 前 级 、 后 级 做 为 方法 名 ， 定 义 一 个 新 的 方法 


单独 使 用 Attribute Methods 举例 : 


Attribute Methods 


class Person 
include ActiveModel::AttributeMethods 


# WA 

attribute method prefix 'clear ' 

HER 

attribute_method_suffix '_contrived?' 

# WA + BA 

attribute_method_affix prefix: 'reset_', suffix: '_to_default 
T 


# 要 处 理 的 属性 
define attribute methods :name 


attr accessor :name 


H 供 查 询 属 性 及 值 
def attributes 

{ 'name' => Qname } 
end 


private 
# A attribute 代替 上 面 要 处 理 的 属性 ， 加 上 前 级 、 后 组 得 到 新 的 方法 名 ， 然 后 
实现 它们 


def attribute contrived?(attr) 
erue 
end 


def clear_attribute(attr) 
send("#{attr}=", nil) 
end 


def reset attribute to default!(attr) 
send("#{attr}=", 'Default Name') 
end 
end 
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Rails 项 目 ， 有 的 步骤 默认 已 经 实现 ， 所 以 使 用 上 可 以 减少 几 个 步骤 ， 但 其 中 的 第 
235 步 是 无 论 如何 都 不 可 省 。 


class Person < ActiveRecord::Base 
attribute method affix prefix: 'me mateys ', suffix: ' is in p 
irate?' 


private 

def me mateys attribute is in pirate?(attr) 
send(attr).to s =~ /NbYARNb/i 

end 


end 


person = Person.find(1) 


person.name # => 'Paul Gillard' 
person.profession # => 'A Pirate, yar!' 
person.me_mateys_name_is_in_pirate? # => false 





person.me_mateys_profession_is_in_pirate? # => true 


主要 用 到 的 方法 ， 都 在 示例 里 。Active Record 基于 它 也 实现 了 一 个 自己 的 
Attribute Methods. 


类 方法 
attribute method prefix 


attribute method suffix 
attribute method affix 


alias attribute # 起 别名 
attribute alias? # # 





attribute alias # RF 
define attribute methods 
define attribute method 


undefine attribute methods 


generated attribute methods 


Attribute Methods 


Note: ActiveRecord::AttributeMethods include ActiveModel::AttributeMethods 
并 修改 了 它 的 部 分 函数 ， 所 以 使 用 Rails 的 话 ， 这 些 方法 是 用 不 了 的 。 
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Dirty 


跟踪 对 象 的 变化 情况 。 其 实 ， 它 们 都 属于 脏 数 据 ， 所 以 起 这 名 字 。 但 有 时 候 很 有 
用 ， 例 如 某 个 字段 一 经 生成 不 允许 更 改 ， 或 者 某 字 段 每 次 更 改 要 确保 与 上 次 不 同 。 


使 用 ActiveModel::Dirty ， 需 要 : 


e include ActiveModel::Dirty 

e 调用 define attribute methods 参数 是 你 想 跟踪 的 属性 

e 在 改变 属性 的 值 之 前 ， 调 用 attr name will change! (4 attr name 换 成 
真正 的 属性 名 ) 

e 在 改变 属性 的 值 之 后 ， 调 用 changes applied 





举例 : 


class Person 
include ActiveModel::Dirty 


define attribute methods :name 
def name 
name 


end 


def name=(val) 


name will change! unless val -- Qname 
@name = val 

end 

def save 


# do persistence work 
changes_applied 
end 


def reload! 
# reset_changes 
end 
end 


Dirty 


运用 Attribute Methods 生成 的 方法 ， 能 精确 跟踪 到 某 属 性 : 


attribute method suffix ' changed?', ' change', ' will change!', 
' was' 


attribute method affix prefix: 'restore ', suffix: '!' 


a m—————————————X sum: n 


下 面 是 对 它们 的 解释 
x changed? 4 返回 true/false, x 属性 有 没有 更 改 ? 
x change # 返回 一 个 数组 有 两 个 元 素 ， 第 1 个 为 x 属性 更 改 前 的 值 ， 第 


2 个 为 X 属性 更 改 后 的 值 
x will change! 4 声明 x 元 素 已 被 更 改 ， 即 使 实际 上 它 并 没有 更 改 。 
X was 4 根据 x changed? 而 来 。 
# 如 果 有 更 改 则 返回 changed attributes 里 x 属性 的 部 分 
， 没有 更 改 则 返回 X 属性 的 值 


restore x! # 消除 对 x 属性 的 更 改 


除 上 述 方法 外 ， 还 有 
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Dirty 


changed? # 返回 true/false’ IH ZH AU S? 
changed # 返回 一 个 数组 ， 所 有 被 更 改 的 属性 
changes 4 返回 一 个 Hash. key 被 更 改 的 元 素 ，Value 是 一 个 数组 
& (有 两 个 元 素 ， 第 145 x 属性 更 改 前 的 值 ， 第 2 个 为 x 
属性 更 改 后 的 值 ) 
previous changes # 类 似 changes， 区 别 是 更 新 成 功 之 后 才 使 用 。 
# 返回 一 个 Hash. key 被 更 改 的 元 素 ，Value 是 一 个 数组 


# (有 两 个 元 素 ， 第 1 个 为 x 属性 更 改 前 的 值 ， 第 2 个 为 
x 属性 更 改 后 的 值 ) 
changed attributes # 返回 一 个 Hash. key 为 被 更 改 的 元 素 ，Value 为 其 更 
改 之 前 的 值 
restore attributes # 清除 更 改 数据 


changes applied 
clear changes information 


attribute previously changed? # 对 已 经 保存 的 对 象 ， 之 前 改变 了 哪些 属性 

attribute previous change # 改变 的 属性 值 是 什么 
| 
Active Record 也 有 同名 模块 ， 它 只 是 对 这 里 的 Dirty 的 封装 ， 并 且 它 并 没有 对 外 提 
BE API. 


Secure Password 
RAK: 


has_secure_password(options = {}) 


实例 方法 : 
authenticate(unencrypted password) 


attr reader :password 


Pj 去 和 attr accessor AM 
password-z(unencrypted password) 


password confirmation-(unencrypted password) 


依赖 于 gem 'bcrypt' > 552/875 password digest 属性 (可 以 没有 password 
属性 )， 使 用 参考 : 


# Schema: User(name:string, password digest:string) 
class User « ActiveRecord::Base 

has secure password 
end 


user - User.new(name: 'david', password: '', password confirmati 
on: 'nomatch' ) 

user.save # => false, 密码 

不 能 为 空 

user.password = 'mUc3mOORsqyRe' 

user.save # => false, Si 
密码 失败 

user.password confirmation = 'mUc3mOORsqyRe' 

user.save 

# => true 

user.authenticate('notright') 

4 => false 

user.authenticate( 'mUc3m00RsqyRe' ) 

# => user 

User.find by(name: 'david').try(:authenticate, 'notright') 

4 => false 

User.find by(name: 'david').try(:authenticate, 'mUc3m00RsqyRe' ) 

# => user 


使 用 has secure password 后 ， 还 会 自动 帮 我 们 添加 校 验 : 


validates length of :password 
validates confirmation of :password 


FW Rails 里 面 默认 的 加 密 、 解 密实 现 : 


require 'bcrypt' 
# => true 


cost = BCrypt::Engine.cost 
# => 10 


unencrypted_password = "password" 
# => "password" 


# m 

password digest = BCrypt::Password.create(unencrypted password, 
cost: cost) 

4 => "$2a$10$GGtvADq0jfb9E2wyANq0jei1ZrJbJrsRSigwtBMlAAfV5dbAEgjt 
Ten 

# 解密 

BCrypt::Password.new(password digest) == unencrypted password 

# => true 


Forbidden Attributes Protection 


Strong Parameters RU Æ X X > params 在 (controller 层 面 ) permit 后 状态 会 变 成 
permitted (进入 白 名 单 )， 只 有 permit 的 属性 才能 进入 我 们 系统 。 为 了 防止 程序 员 
遗漏 或 图 省 事 ， 直 接 传递 白 名 单 ， 我 们 可 以 在 (model 层 面 ) 里 做 校 验 ， 如 果 发 现 有 属 
性 不 在 白 名 单 内 ， 则 报错 : 


y 


# app/controllers/people controller.rb 


class PeopleController « ActionController::Base 
def cre 





Person.create(person params) 


Em 
Ha ww HA m 
É = 


Person.create(params[:person]) 
end 


private 


def person params 
params.require(:person).permit(:name, :age) 
end 


end 


4 app/models/people.rb 
class Person « ActiveRecord::Base 
include ActiveModel::ForbiddenAttributesProtection 


end 


此 模块 用 于 遗留 项 目 ， 它 的 使 用 ， 还 需要 安装 gem 'strong parameters' 


if attributes.respond to?(:permitted?) && !attributes.permitted? 
raise ActiveModel::ForbiddenAttributesError 
end 


Rails 的 where 查询 也 有 类 似 Mass Assignment 保护 。 


它 主要 针对 的 是 : 在 Controller 和 View 里 通过 params 给 record 对 象 属 性 赋值 
(AttributeAssignment) 


注意 ， 这 里 做 了 判断 ， 并 不 是 强制 执行 ， 所 以 和 ActionController # 7&.E 2484 ° 


Serialization 


serializable hash(options = nil) 序列 化 操作 ， 提 供 了 :only, :except 选 
项 。 常 用 的 as json 封装 并 扩展 了 它 。 


使 用 Serialization 需要 record.respond to? :attributes # => true 因为 转换 
的 过 程 使 用 到 相应 model 的 attributes 实例 方法 。 


此 外 ， 还 有 相关 module 及 方法 : 
JSON 


4 封装 了 上 面 的 serializable hash， 并 提供 :root 选项 


as json 
4 AMT attributes- FA X 2 NAA 


from json 


Xml 


H 将 对 象 转 化 成 xml 格式 
to xml 


H 先 将 xml 格式 成 Hash， 再 调用 了 attributes- 方法 ， 给 对 象 赋值 
from xml 


该 模块 在 Rails 5 已 被 移 除 。 


注意 几 个 转化 成 json 方法 之 间 的 区 别 : 


person = Person.new 
person.name - "Bob" 


person.serializable hash # => {"name"=>"Bob"} 
person.as_json # => {"name"=>"Bob"} 
person.to_json # => "{\"name\":\"Bob\"}" 


Serialization 
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Callbacks - 快速 提供 3 个 回调 方法 


define model callbacks(*callbacks) 快速 定义 Model 里 使 用 的 3 个 回调 方 
法 ， 它 们 是 : before x^ around x 和 after x. 
一 般 的 ，ORM 都 会 提供 大 量 的 回调 函数 ， 其 中 有 的 彼此 之 间 还 很 相似 。 直 接 使 用 
Active Support 那 一 套 回调 机 制 的 话 ， 咯 显 麻烦 ， 还 会 有 重复 代码 。 所 以 ，Active 


4€ AK 


Model 封装 了 Active Support， 使 得 定义 回调 函数 变 得 简单 方便 。 


使 用 举例 : 


a 
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Callbacks - 快速 提供 3 个 回调 方法 


require 'active model' 


class Person 
extend ActiveModel::Callbacks 


define model callbacks :update 


4 运用 define model callbacks 自动 生成 的 方法 
before_update :reset_me 

# around update 

after update  :say success 


# 为 了 统一 ， 易 于 理解 ， 这 里 的 方法 名 一 般 用 : update 
# 但 这 并 不 是 规定 死 的 ， 也 可 以 不 一 致 。 比 如 这 里 用 的 是 : update_me 
def update me 
run callbacks(:update) do 
p "update me AsE RATTE An 
p "... before- around 和 after 就 是 针对 这 里 的 代码 而 言 的 1 " 
end 


p "update me 站 正 要 执行 的 代码 ， 还 可 以 有 其 它 内 容 " 


p "..， 但 为 了 简单 、 避 免 混 清 ， 不 建议 再 放 其 它 任何 代码 |" 


def reset me 
p "在 update me 申 正 要 执行 的 代码 之 前 ， 执 行 这 里 的 代码 " 


def say_success 
p "在 update me 申 正 要 执行 的 代码 之 后 ， 执 行 这 里 的 代码 " 


person = Person.new 


person.update me 


上 面 例子 里 的 before update 和 after update 方法 我 们 并 没有 显 式 定义 ， 
是 define model callbacks 帮 我 们 自动 生成 的 。 


Callbacks - 快速 提供 3 个 回调 方法 
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class Person « ActiveRecord::Base 
end 


params = ActionController::Parameters.new(name: 


Person.new(params) 
# => ActiveModel::ForbiddenAttributesError 


params.permit! 
Person.new(params) 
# => #<Person id: nil, name: "Bob"> 


'Bob') 


Active Record 242 3$ M] AR 


Web 应 用 使 用 到 数据 库 ， 而 管理 数据 库 使 用 的 是 SQL 语言 。 我 们 不 需要 专门 去 学 
J SQL， 只 需要 用 Ruby 语言 ， 写 Ruby 代码 就 能 实现 数据 库 的 相关 操作 (也 就 是 各 
种 简单 、 复 杂 的 读 写 操作 )。 


e Scoping 
包括 Default、Named 
e Relation 


包括 Spawn Methods ` Query Methods ` Finder Methods ` Calculations ` 
Batches ` Delegation ` Predieate-Builder ^ Merger 


e Querying 
e Persistence 
即将 被 废除 的 gem 'activerecord-deprecated finders' 
e Counter Cache 
e Attribute Assignment 
主要 工作 由 ActiveModel::AttributeAssignment ZIR > 3X € ^R AAU © 
e Attribute Methods 


包括 Before Type Cast ` Dirty ` Primary Key ` Query ` Read & Write ^ 
Serialization » Time Zone Conversion 


e Nul-Helation 


e Dynamie-Matehers 


Relation(Arel) 


对 Relation 的 操作 。 哦 ， 我 们 先 理解 概念 。 
e 为 什么 不 完全 用 Ruby & SQL? 
Ruby 慢 ， 人 性 化 ; SQL 快 ， 不 易 读 写 。 
e 如 何 充分 利用 两 者 优点 ， 特 别 是 我 们 要 做 复杂 查询 的 时 候 ? (复杂 查询 = 简单 
的 查询 + 简单 的 查询 + …) 


"(Ruby 查询 -> SQL 查询 ，Ruby 查询 -> SQL 查询 ) -> 结果 " FG "(Ruby 查询 + 
Ruby 查询 -> SQL 查询 ) -> 结果 " 效率 要 低 。 所 以 尽量 不 要 在 Ruby - SQL 两 个 层 
面 之 问 转 来 转 去 ， 尽 量 把 多 个 Ruby 查询 转化 成 相应 的 一 个 SQL 查询 。 


e 如 何 实现 ? 


运用 中 间 状 态 ， 也 就 是 Relation. 每 次 查询 并 不 是 由 正 的 查询 (因为 没 走 到 SALE 
面 )， 而 是 保存 一 个 中 间 状 态 ， 当 你 所 有 的 查询 条 件 都 写 完 了 ， 才 进入 SQL 的 层 
面 。 理 论 上 ， 这 些 简单 的 查询 最 后 都 能 组 合成 SQL 4 © 


e 好 处 ? 


延迟 加 载 。 我 们 在 Controller 里 有 一 个 查询 语句 ， 结 果 赋值 给 一 个 实例 变量 ， 原 本 
的 意图 是 在 View 里 显示 的 。 茶 天 需求 更 改 了 ， 我 们 不 必 再 显示 这 个 查询 结果 ， 但 
Controller 里 我 们 忘记 删除 这 部 分 的 代码 (这 都 能 忘 ? )， 结 果 每 次 都 要 做 大 量 无 用 的 
查询 工作 。 引 入 中 间 状 态 后 ， 就 能 起 到 延迟 加 载 的 作用 ， 不 到 最 后 的 调用 ， 不 做 
SQL 查询 (停留 在 Ruby 层面 ) 。 


链 式 查询 ， 效 率 高 。 上 面 已 经 提 到 了 "(Ruby 查询 -> SQL 查询 ，Ruby 查询 -> SQL 
查询 ) -> 结果 " 比 "(Ruby 查询 + Ruby 查询 -> SQL 查询 ) -> 结果 " 效率 要 低 。 
e 如 何 区 分 ? 


在 控制 台 里 执行 一 下 查询 命令 ， 看 返回 结果 的 cass (类 型 )。 有 
ActiveRecord::Relation ` ActiveRecord::AssociationRelation 和 
ClassName::ActiveRecord Relation 等 包含 Relation 字样 的 就 是 了 。 


Relation 就 类 似 没 有 名 字 的 scope 。 当 涉及 跨 表 查询 时 ， 使 用 链 式 查询 可 以 很 大 程 
度 的 提高 效率 。 更 多 请 查看 接口 Active Record Query Interface 


Relation 


Note: 这 里 部 分 是 对 多 个 对 象 的 操作 ， 对 Relation 的 操作 ; 不 是 查询 操作 。 
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Relation 文件 下 的 方法 


方法 
build & new 
create 
create! 


delete 


delete all 


destroy 


destroy all 


find or create by 


find or create by! 
find or initialize by 


find or create by! 


update 


update all 


和 


新 建 record 对 象 

新 建 并 保存 record 对 象 

新 建 并 保存 record 对 象 ， 如 果 有 异常 则 报错 
基于 SQL 删除 指定 id 的 record 对 象 


基于 SQL 删除 relation 包含 的 所 有 record 对 象 

可 以 先 把 这 些 record 对 象 查询 出 来 ， 也 可 以 删除 的 时 候 
传 条 件 进行 查询 

删除 指定 id 的 record 对 象 ， 会 运行 回调 函数 

删除 relation 包含 的 所 有 record 对 人 象 ， 会 运行 回调 函数 
根据 所 给 的 属性 ， 查 询 record 对 象 ; HAW KA] > Mal 
建 


根据 所 给 的 属性 ， 查 询 record 对 象 ; 若 查 询 不 到 ， 则 创 
建 。 创 建 则 有 可 能 失败 ， 失 败 报错 


根据 所 给 的 属性 ， 查 询 record 对 象 ; 若 查询 不 到 ， 则 初 
始 化 


传递 参数 ids、attributes， 所 有 指定 id 的 record 对 象 都 
会 更 新 

用 的 是 自己 的 update 方法 

更 新 整个 relation 包含 的 record 对 象 ( 先 查 询 出 来 )， 参 
数 为 更 新 内 容 


方法 


explain 


reset 


load 
reload 


cache key 


values 


where values hash 


to sql 


size 


除 上 述 方 法 外 ， 还 有 : 


解释 


判断 集合 是 否 等 价 于 relation. 
这 里 的 集合 ， 并 不 限于 relation > 4n T A KA 


JT 
ANY 
AU 


多 个 ? 
也 就 是 relation.count > 1 


1. 模拟 在 各 自 数 据 下 的 执行 效果 
2. 解释 生成 的 sql 


如 果 对 所 得 的 relation 进行 了 处 理 ， 但 还 没有 保存 ， 使 
用 它 可 重 置 之 前 的 处 理 


执行 查询 操作 ， 但 返回 的 是 relation 


reset + load 


返回 规格 化 的 所 有 查询 条 件 。 如 果 你 用 的 查询 条 件 太 多 
了 ， 可 用 它 来 查看 


返回 所 有 where 查询 条 件 ， 结 果 并 不 准确 


一 般 地 ， 使 用 to sql 可 以 方便 的 查看 生成 的 Sql 语 
4 


toa 

eager loading? 

encode with 

initialize copy 
inspect 

joined includes values 
pretty print 
scope for create 
scoping 


uniq value 


我 们 不 需要 也 不 推荐 使 用 toa 强制 转换 Relation 成 数组 。 


Query Methods 


介绍 的 方法 都 在 ActiveRecord::QueryMethods 
提供 方法 : 


方法 解释 
bound attributes 


创建 一 个 record 对 象 ， 调 用 者 是 Relation 对 象 . 
没 找到 合适 的 使 用 场景 


creato wiih it £55 create with value 的 值 ， 在 很 多 地 方 会 间接 用 到 


已 
通常 有 要 配合 其 它 查询 方法 使 用 ， 返回 是 Relation. 否则 使 用 
的 是 数组 的 uniq 返回 的 不 是 Relation 


eager load 后 文 解 释 


distinct & uniq 


给 一 个 scope 增加 方法 ， 返 回 的 仍然 是 scope. 
如 果 传 递 的 是 block, 则 可 以 直接 调用 block 里 面 的 方法 , 如 


extending 果 传 递 的 是 module, 则 可 以 调用 module 里 面 的 方法 。 
Ba 这 会 大 大 提高 复杂 度 ， 但 扩展 时 可 以 使 

from 从 符合 条 件 的 record 开始 

group 后 文 解释 

er having = 7 A (group) 53 XE: 第 选 条 条 件 ， 分 组 后 的 数据 组 内 再 
第 选 ; where 则 是 在 分 组 前 筛选 

includes 后 文 解释 

joins 后 文 解释 

left_joins & 

left outer joins 

limit 限制 结果 数目 

lock 锁定 结果 

none 返回 一 个 空 的 Relation 

offset 类 似 from, 但 它 传递 的 是 "第 几 条 "， 并 且 数 据 不 够 的 话 可 循 


环 ; 而 后 者 传递 的 是 查询 条 件 ， 不 符合 条 件 返回 空 
or 对 应 SQL 里 的 "或 "查询 


preload 后 文 解释 


readonly 查询 结果 只 读 ， 不 可 写 

references 后 文 解 释 

reorder 重新 按 条 件 排 序 。 在 这 之 前 有 排序 的 话 ， 忽 略 它 们 

reverse order 反 转 之 前 的 排序 结果 

重新 按 KEH 。 在 这 之 前 的 排序 a FE € 没有 冲 突 的 情 
况 下 ， 保 留 它们 ; 有 冲突 的 情况 下 ， 和 忽略 它们 

select 后 文 解释 


ARF 条 可 以 ZN o 可 以 忽略 其 的 一 个 
ee a. 有 多 个 。 使 用 unscope 可 咯 其 中 的 一 人 


where 后 文 解释 
where(opts = :chain, *rest) 
不 过 这 容 匈 引起 注入 攻击 。 
e 传递 数组 。 
1) 数组 第 一 个 元 素 做 为 查询 条 件 ( 占 位 符 '?')， 后 面 的 元 素 按 顺序 辅 助 完成 ; 
2) 数组 第 一 个 元 素 做 为 查询 条 件 ( 占 位 符 "key')， 后 面 的 元 素 放 到 一 个 哈 希 里 ， 辅 助 
完成 3 
3) 数组 第 一 个 元 素 做 为 查询 条 件 ( 占 位 符 '%')， 后 面 的 元 素 转 义 后 ， 按 顺序 辅助 完 
成 。 
传递 多 个 参数 时 ， 上 默认 把 它们 当做 数组 处 理 ， 尽 管 没 有 使 用 中 括号 [ 
e f db o 
包括 用 花 括 号 () 或 者 裸 哈 希 。 
使 用 哈 希 ， 还 有 一 个 好 处 ， 可 以 很 直接 的 使 用 范围 ， 如 : 


Comment.where(created at: Qthe date.beginning of day..Qthe date. 
end of day) 


e 配合 joins 


如 果 要 joins HE X > where 里 的 查询 语句 参数 和 之 前 一 样 ， 但 被 join 的 表 名 要 包 
含 在 查询 条 件 里 。 


User.joins(:posts).where(( "posts.published" => true }) 
User.joins(:posts).where(( posts: { published: true } }) 


select(*fields) 
默认 find 查询 所 有 属性 ， 也 就 是 Select *. 
如 果 只 想 查 询 部 分 属性 ， 你 可 以 自己 指定 : 
e 传递 block， 返 回 数 组 
e 传递 属性 名 ( 列 )， 结 果 仅 包含 这 些 项 
group(*args) 
根据 所 传递 的 属性 ， 对 结果 进行 分 组 。 和 select 对 比 : 
User.select([:id, :name]) 


=> [#<User id: 1, name: "Bar"», #<User id: 2, name: "Bar">, 
Z«User id: 3, name: "Foo"> 


User.group( :name) 


=> [#<User id: 3, name: "Foo", ...>, £«User id: 2, name: "Bar", 
d 
User.where('tag list !- ?', '').group(:tag list).order('count al 


l desc').count 


group 通常 要 配合 其 它 查询 语句 或 条 件 使 用 ， 单 独 使 用 只 会 有 "去 重 "效果 (record & 
性 相同 的 话 ， 只 保留 最 后 一 个 record 3%) ° 


having(opts, *rest) 


和 group 对 比 : having 是 筛选 条 件 ，group 是 分 组 。 


Rails € having 不 能 脱离 group 单独 使 用 。 


Order.having('SUM(price) » 30').group('user id') 


order(*args) 

需要 知道 : 属性 和 规则 。 如 果 不 指定 规则 ， 则 用 默认 的 。 
limit(value) 和 offset(value) 

指定 最 多 获取 多 少 条 数据 。 


User.limit(10) # Selene SQL has 'LIMIT 10' 
User. limit(10).limit(20) # generated SQL has 'LIMIT 20' 


类 比 : 分 页 时 的 ' 第 几 页 ' 类 似 offset, 而 ' 每 页 多 少 条 数据 ' 类 似 limit 
readonly(value = true) 

注意 是 数据 库 返 回 的 结果 就 是 只 读 ， 和 attr_readonly 是 两 码 事 。 
users = User.readonly 


users.first.save 
-» ActiveRecord::ReadOnlyRecord: ActiveRecord::ReadOnlyRecord 


reorder(*args) 
重新 排序 。 调 用 了 其 他 人 号 的 query 方法 ， 但 对 排序 不 满意 的 ， 可 以 重新 排序 
joins(*args) 


如 果 要 根据 关联 表 来 查询 ，joins 后 面 的 where 查询 语句 里 要 包含 被 join & 89 
Be 


Category.joins(:posts) 
4 => SELECT categories.* FROM categories 
INNER JOIN posts ON posts.category id - categories.id 


Post.joins(:category, :comments) 

4 => SELECT posts.* FROM posts 
INNER JOIN categories ON posts.category id - categories.id 
INNER JOIN comments ON comments.post id - posts.id 


product - Product.first 
product.catalogs.joins(:catalogs products) 
.Where('catalogs products.is default = ?', true) 
4 => SELECT DISTINCT 'catalogs' .* FROM ‘catalogs INNER JOIN ‘ca 
talogs products' 
"catalogs products catalogs' ON 
"catalogs products catalogs . catalog id = 
"catalogs. id INNER JOIN 'catalogs products' ON 'catalogs' 
. Id = 
“catalogs_products’. "catalog id' WHERE 
"catalogs products . standard product id' = 100011 AND 
(catalogs products.is default = 1) 


Bpe———————————————É Se] 
includes(*args) 和 joins 类 似 ， 唯 一 的 区 别 在 于 : 它 是 预先 加 载 ， 第 一 次 执行 
会 慢 ， 后 续 不 再 执行 。 


Post.includes(:comments).where("comments.visible" => true) 


distinct(value - true) aliased as: uniq 
explain() 看 看 转化 成 SQL 是 什么 样 。 


none 返回 一 个 空 的 Relation， 对 后 续 操 作 很 有 用 。 可 以 充分 利用 Relation 链 式 
调 有 用、 延迟 加 载 等 特性 。 


not "与 或 非 " 里 面 的 " 非 "， 例 如 "IS NOT NULL" 查 询 。 


references 使 用 includes 可 以 预 加 载 多 个 关联 表 ， 如 果 后 续 还 有 根据 关联 表 进 
行 查询 的 ， 需 要 用 references 指明 用 哪 张 关 联 表 。 否 则 ， 查 询 会 出 错 。 但 如 果 后 续 
的 查询 是 以 hash 的 形式 提供 的 话 ， 则 不 必 使 用 references 也 可 以 。 


order 排序 。 它 在 default scope 之 前 执行 ， 也 就 是 说 default_scope 有 可 能 会 
覆盖 之 前 的 排序 。 


left outer joins 使 用 举例 : 


User.left outer joins(:posts) 
# => SELECT "users".* FROM "users" LEFT OUTER JOIN "posts" ON 
bosts usereli E Users Ms 


Note: 注意 区 分 Rails 里 的 group 和 SQL 里 的 group_by 
相关 SQL SQL Functions 
参考 官方 文档 Active Record Query Interface 
最 后 
查 表 操作 (数据 库 读 操 作 )。 大 部 分 是 Ruby 层面 ， 一 般 可 多 条 件 链 式 查询 。 


Query Methods 里 的 方法 和 Collection Proxy 里 的 方法 很 类 似 ， 区 别 在 于 前 者 主要 
是 对 当前 表 进 行 操作 ; 而 后 者 主要 是 对 其 关系 表 进 行 操作 。 


Query Methods 和 Finder Methods 也 有 类 似 之 处 ， 区 别 在 于 前 者 返回 的 是 
Relation 对 象 ， 可 以 链 式 查询 ; 而 后 者 直接 返回 的 已 经 是 结果 ， 不 可 再 链 式 查询 。 


BER: 参数 带 block 的 ， 会 离开 Ruby 层面 ， 执 行 SQL 查询 ， 返 回 结果 。 


要 善于 使 用 这 里 的 语句 ， 数 据 放 在 数据 库 和 数据 放 在 内 存 有 很 大 的 区 别 ; 放 在 内 存 
和 是 否 返 回 也 有 很 大 的 区 别 。 


Note: 返回 的 多 是 Relation 5 SQL A WR: 有 find 字样 的 绝对 不 是 它 。 


Preload, Eagerload, Includes 和 Joins + 


3£ iR Ju fà > 4e Relation > scope 预先 加 载 ， 如 includes 


N +1 


一 次 查询 


doctors = Physician.all 


# N 次 查询 

doctor.patients.each do |patient| 
puts patient.name 

end 


includes 


把 关系 表 数 据 也 查询 出 来 。 两 个 查询 都 要 做 ， 关 联 对 象 也 需要 放 到 内 存 。 
User.includes(:posts) 


=> SELECT "users".* FROM "users" 
-» SELECT "posts".* FROM "posts" WHERE "posts"."user id" IN (1, 
2, 3) 


Bp——————————————————————AÀÁn—] rn] 


# 第 一 次 调用 ， 需 要 查询 ， 花 销 大 

# 目的 :查询 主 表 和 关联 表 

User.includes(:posts).where('posts.desc = "ruby is awesome"').re 
ferences(:posts) 


ves FED 
SELECT "users"."id" AS tO rO, "users"."name" AS tO r1, "posts"." 
dd AS ti rọ, 

"posts". "title" AS ti1-ri, 

"posts"."user id" AS tà r2, "posts"."desc" AS t1 r3 


FROM "users" LEFT OUTER JOIN "posts" ON "posts"."user id" - "use 
ns! ^ wid” 
WHERE (posts.desc = "ruby is awesome") 


# 再 次 调用 ， 不 需要 查询 ， 花 销 为 零 
Qcustomers = Customer.joins(:products).where("products.is master 
- true") 
特点 ， 生 成 一 条 还 是 两 条 SQL 查询 语句 ， 取 决 于 写法 。 
可 分 为 2 种 不 同情 况 ， 和 preload 一 样 、 和 earge load 一 样 。 
性 能 最 慢 。 
通过 中 间 表 的 话 ， 默 认 也 加 载 。 


a.includes(:bs).where(bs.x ...) includes 只 包含 符合 条 件 的 a 和 a 下 面 符 
合 条 件 的 bs 


includes 如 果 不 接 where 查询 ， 则 只 做 预 加 载 ， 没 有 过 滤 的 作用 。 
joins 


普通 的 查询 条 件 ， 关 联 对 象 不 会 放 到 内 存 。 


Query Methods 


User.joins(:posts) 
-» SELECT "users".* FROM "users" INNER JOIN "posts" 
ON "posts'"."user id" = "users"."id" 


# 第 一 次 调用 ， 需 要 查询 ， 花 销 一 般 


# 目的 : 查询 主 表 ， 关 联 表 仅 做 为 查询 条 件 之 一 


posts = Post.joins(:comments) 
# => Post Load (0.1ms) SELECT "posts".* FROM "posts" INNER JOIN 
"comments" ON "comments"."commentable id" = "posts"."id" AN 


"comments"."commentable type" - 'Post' 


# 再 次 调用 ， 也 需要 查询 ， 花 销 一 般 
posts.first.comments 
4 => Comment Load (0.2ms) SELECT "comments".* FROM "comments" 
WHERE "comments"."commentable id" = ? AND "comments"."comme 
ntable type" - ? 
[["commentable id", 1], ["commentable type", "Post"]] 


特点 ， 不 会 查询 出 关联 表 的 数据 ， 仅 做 为 查询 条 件 。 
joins 即使 不 接 where 查询 ， 也 有 过 滤 作 用 ， 黑 认 是 INNER JOIN. 


复杂 的 joins 
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4 has and belongs to many 
product has and belongs to many :devices 


Product.joins("join devices products on products.id - devices pr 
oducts.product id") 
.Where(["devices products.device id = ?", params[:device 


id]]) 


4 has many : through 
has many :catalogs products 
has many :catalogs, :through -» :catalogs products 


Product.joins(:catalogs products).where(catalogs products: 
(catalog id: params[:cat 
alog_id]}) 


preload 


类 似 includes 的 子 集 。 
User.preload(:addresses) 


=> SELECT "users".* FROM "users" 

=> SELECT "addresses".* FROM "addresses" WHERE "addresses"."use 
road" IN (1- 2) 

特点 ，SQL 查询 语句 始终 是 两 条 (单独 的 数据 库 查询 )。 

后 续 ， 不 能 以 关联 表 做 为 查询 条 件 。 

性 能 最 快 。 

通过 中 间 表 的 话 ， 默 认 也 加 载 。 


a.preload(:bs).where(bs.x ...) preload 包含 符合 条 件 的 a 和 a 下 面 所 有 的 
bs 


Note: 实际 应 该 是 a.joins(:bs).where(bs.x ...).preload(:bs) 


eager load 


User.eager load(:posts) 
-» SELECT "users"."id" AS tO rO, "users"."name" AS tO r1, 
FROM "users" LEFT OUTER JOIN "posts" ON "posts"."user id" = 
"users... "id" 

特点 ，SQL 查询 语句 始终 只 有 一 条 (使 用 了 LEFT JOIN) ° 

性 能 中 等 。 

default scope 不 起 作用 。 

通过 中 间 表 的 话 ， 要 明确 指出 才 加 载 。 


references 


includes 后 面 的 查询 条 件 ， 用 的 是 "关联 表 . 属 性 "， 有 时 候 Rails 不 能 推断 出 这 个 ' 关 
联 表 ' 到 底 是 哪个 (可 以 includes 多 个 关联 表 )， 需 要 用 references 指明 。 


Rails 3 比较 ' 宽 松 '，includes 有 时 候 不 指定 references 也 可 以 工作 。Rails 4 比 
较 ' 严 格 '，includes 需要 指定 references 才能 工作 。 


举例 : 


User.includes(:posts).where("posts.name = 'foo'") 
4 => Doesn't JOIN the posts table, resulting in an error. 


User.includes(:posts).where("posts.name = 'foo'").references(:po 
sts) 
4 => Query now knows the string references posts, so adds a JOIN 


参考 


3 ways to do eager loading (preloading) in Rails 3 & 4 
eager loading in rails 


Query Methods 读 取 、 设 置 查询 方法 


除 【Query Methods 】 介 绍 的 方法 外 ， 还 有 以 下 读 取 、 设 置 查询 方法 。 它 们 都 是 用 
元 编程 生成 的 。 


在 Relation 文件 下 ， 有 代码 : 


MULTI VALUE METHODS = [:includes, :eager load, :preload, :select 
, ‘group, 

:order, :joins, :where, :having, :bind, 
:references, 

:extending, :unscope] 


SINGLE VALUE METHODS = [:limit, :offset, :lock, :readonly, :from 
, :reordering, 

reverse order, :distinct, :create with, 
: uniq] 


E 29:5] E] 
在 Query Methods 文件 下 ， 使 用 它们 。 读 取 或 设置 指定 的 查询 条 件 。 


Query Methods 


MULTI VALUE METHODS.each do |name| 


def Z(name) values # def select values 
@values[:#{name}] || [] # @values[:select] || [] 
end # end 
# 
def Z(name) values-(values) # def select values-(values) 
@values[:#{name}] = values # @values[:select] = values 
end # end 
end 


(SINGLE VALUE METHODS - [:create with]).each do |name| 


def Z(name) value # def readonly value 
@values[ :#{name}] # @values[:readonly] 
end # end 
end 


SINGLE_VALUE_METHODS.each do |name | 


def #{name}_value=(value) # def readonly_value=(value) 
@values[:#{name}] = value # @values[:readonly] = val 
ue 
end # end 
end 


aue] wj 
根据 以 上 代码 ， 生 成 方法 : 
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includes values 
includes values- 


eager load values 
eager load values- 


preload values 
preload values- 


select values 
select values- 


group values 
group. values- 


order values 
order values- 


joins values 
joins values- 


where values 
where values- 


having values 
having values- 


bind values 
bind values- 


references values 
references values- 


extending values 
extending values- 


unscope values 
unscope values- 


limit value 
limit value- 


offset value 
offset value- 


lock value 
lock value- 


readonly value 
readonly value- 


from value 
from value- 


reordering value 
reordering value- 


reverse order value 
reverse order value- 


distinct value 
distinct value- 


create with value- 


uniq value 
uniq value- 


includes ` joins 查询 对 应 的 是 关联 名 字 ，where 对 应 的 是 表 名 。 
一 对 多 关系 时 : 


joins + where 查询 会 对 每 个 关联 进行 查询 ， 所 以 结果 会 有 重复 。 
使 用 uniq 后 前 者 数目 和 使 用 includes 一 样 。 


includes + where 查询 到 符合 条 件 就 自动 终止 ， 所 以 结果 没有 重复 。 
相当 于 自 带 uniq 功能 。 


一 对 一 关系 (has one 或 belongs to) 


没有 上 述 差异 ， 因 为 它 在 另 一 个 层面 解决 了 重复 问题 。 
判断 nil 


class Person 
has_many :friends 
end 


class Friend 


belongs_to :person 
end 


对 应 : 


Person.includes(:friends).where( :friends -» ( :person id => nil 


+) 


class Person 

has many :contacts 

has many :friends, :through -» :contacts, :uniq -» true 
end 


class Friend 

has many :contacts 

has many :people, :through -» :contacts, :uniq -» true 
end 


class Contact 
belongs to :friend 


belongs to :person 
end 


对 应 : 


Person.includes(:contacts).where( :contacts => { :person id => n 


T) 
另外 一 种 解法 : 
Person.includes(:contacts).where( :contacts => { :id => nil } ) 
ZAIE N RBA IE : 
# 取出 所 有 (KE) ， 不 在 里 面 则 表示 nil 
Person.where('id NOT IN (SELECT DISTINCT(person id) FROM friends 
eo) 
如 果 把 has many 改 为 has one "5 ? 


Person.includes(:contact).where( :contacts => { :person id => nil 


了 ) 
E = ES wj 





7| Bf FE nil 

以 下 几 个 查询 几乎 等 价 : 
members.includes(:responses).where('responses.id IS NOT NULL') 
members.includes(:responses).where.not(responses: ( id: nil }) 


members.joins(:responses) 


看 情况 决定 是 否 要 加 unig 条 件 。 
关联 的 关联 


class Employee < ActiveRecord::Base 
belongs to :company 
end 


class Company « ActiveRecord::Base 
has many :employees 
has many :addresses 

end 


class Address « ActiveRecord::Base 
belongs top :company 
end 


Employee.joins(:company -» :addresses). 
where(:addresses => ( :city => 'Porto Alegre' }) 
KK AAE 
一 对 一 
直接 上 是 不 会 发 生 的 ， 但 实际 上 ， 如 果 没 有 删除 关系 对 象 的 话 ， 也 会 有 : 


group + having 


Order.joins( :request refund ).group( 'orders.id' ).having( 'cou 
nt( order id ) » 1' ) 


一 对 多 


group + having 


Order.joins( :request refunds ).group( 'orders.id' ).having( 'co 
unt( order id) > 1' ) 


counter cache 


belongs to :project, counter cache: true 


当 使 用 了 counter cache 时 可 以 先 运 行 reset counters 确保 数据 准确 ， 然 
后 运用 计数 器 : 


Project.where( 'vacancies count > ?', 1 ) 
统计 并 排序 


users = User.where('tag list !- ?', '').group(:tag list).order(' 
count all desc').count 


按 指 定 的 数组 顺序 排列 


Model.where(id: ids).order("field(id, #{ids.joins(',')})") 


Spawn Methods 


方法 解释 


t 查询 方法 有 多 个 ， 并 且 可 以 链 式 调用 。 使 用 except 忽略 之 前 的 某 个 
re 查询 方法 


merge  ? X Relation, 则 做 为 查询 条 件 ， 返 回 仍然 是 Relation ; 参数 是 数 
99 — m, 则 返回 前 者 的 查询 结果 和 此 数组 的 交集 


查询 方法 有 多 个 ， 并 且 可 以 链 式 调用 。 使 用 only 指定 只 能 使 用 的 查询 


only — 方法 


4 4 4t Relation It > merge 也 和 joins ` includes 等 一 样 有 联合 查询 的 效果 。 


except 和 unscope 功能 上 类 似 。 区 别 在 于 后 者 在 使 用 上 ， 可 以 选择 更 多 类 


型 。 
除 上 述 方法 外 ， 还 有 : 
spawn 
merge! 


VALID FIND OPTIONS = [ :conditions, :include, :joins, :limit, :o 


ffset, :extend, 
‘order, :select, :readonly, :group, :havi 


ng, :from, :lock ] 


一 种 merge 转 普通 查询 : 
之 前 


User.joins(:account).merge(Account.where(:active => true)) 


之 后 


User.joins(:account).where(:accounts => ( :active => true }) 


并 不 是 所 有 merge 都 可 转换 成 where， 但 能 转换 的 话 ， 请 务必 优先 用 where. 


Batches 


find each 
find in batches 


in batches 


—k > find each 后面 参数 都 是 block， 此 时 作用 的 find in batches AM 
(:batch_size 默认 是 1000) 


Finder Methods 
实例 方法 : 

exists? 

find 

find by 


find by! 


take 
take! 


fe : 


first 
first! 


second 
second! 


third 
third! 


fourth 
fourth! 


fifth 
fifth! 


forty_two 
forty_two! 


last 
last! 


除 上 述 方法 外 ， 还 有 一 些 protected 方法 ， 但 它们 一 般 不 会 直接 使 用 到 。 


Finder Methods 


Rails 5 € find 可 以 传递 数组 ， 如 果 没 有 明确 排序 的 话 ， 上 默认 就 使 用 数组 里 
TLR HMA > AKT © 
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Calculations 
按 条 件 对 数据 进行 统计 。 


总 数 
平均 值 


count # 
# 
maximum # 最 大 值 
# 
# 


average 


最 小 值 


值 的 总 和 


minimum 
sum 


pluck # 获取 所 有 指定 的 属性 
ids # 获取 所 有 的 id 属性 


# count, sum, average, minimum, fr maximum 都 是 封装 它 而 来 
calculate 


它们 都 是 直接 返回 结果 。 


查 表 操 作 (数据 库 读 操作 )。 大 部 分 是 SQL 层面 ， 一 般 不 可 多 条 件 链 式 查询 。 


返回 的 都 是 结果 ， 不 是 Relation 。 


HashMerger-&-Merger 

是 Spawn Methods 里 的 merge ` merge! 方法 的 底层 实现 。 

在 merger 对 象 非 Array、 非 Relation、 非 proc 等 情况 下 才 使 用 到 。 
Delegation 

Predicate Build 


Collection Proxy 


通过 某 个 对 象 ， 对 其 关联 的 对 象 进行 操作 。 
它 继 承 于 Relation， 只 是 稍微 做 封装 ， 所 以 接口 上 也 有 很 多 类 似 之 处 。 


对 外 提供 接口 。 


有 破坏 行为 : 


«« & push & append 
prepend 


to a & to ary 
reset 

replace 
reload 


create 
create! 


delete 
delete all 


destroy 
destroy all 


clear 


count 
any? 
many? 


empty? 


length 
size 


include? 


loaded? 


new & build 
concat 
distinct & uniq 
find 

first 

last 

second 

third 

fourth 

fifth 
forty_two 
scope & spawn 
scoping 


select 


take 


arel 


target 


load_target 


proxy_association 


Scoping 


虽然 只 有 4 个 方法 ， 但 很 实用 。 


方法 解释 
scope 命名 scope 
default scope 设置 默认 scope 
和 
方法 解释 
unscoped 跳 过 之 前 设置 的 scope 
all all 方法 ， 上 默认 已 经 scope 
scope 


重点 说 说 这 个 方法 。 
两 个 参数 : 第 一 个 是 名 字 ， 第 二 个 是 内 容 ， 需 要 以 proc 的 形式 定义 。 
scope 相当 于 类 方法 ， 可 检索 、 查 询 对 象 


可 执行 一 系列 a) 4 igie 4] > 40: 


where(color: :red).select('shirts.*').includes(:washing instruct 
ions) 


class Shirt « ActiveRecord::Base 
scope :red, -» ( where(color: 'red') ) 
scope :dry clean only, -> { joins(:washing instructions) 
.where('washing instructions.dry c 
lean only = ?', true) } 
end 


可 以 调用 Shirt.red 和 Shirt.dry clean only . Shirt.red 功能 和 
Shirt.where(color: 'red') 一 样 。 


也 就 是 说 ， 功 能 上 和 以 下 代码 一 样 : 


class Shirt < ActiveRecord::Base 
def self.red 
where(color: 'red') 
end 
end 


scope 返回 的 是 Relation ， 而 不 是 数组 


你 可 以 调用 Shirt.red.first , Shirt.red.count , Shirt.red.where(size: 
'small') 等 .但 是 Relation 也 可 以 有 数组 的 行为 , 如 

Shirt.red.each(&block) , Shirt.red.first ,和 

Shirt.red.inject(memo, &block) 4» 


scope 可 以 链 式 调用 


Shirt.red.dry clean only 运行 结果 是 red 和 dry clean only 综合 的 
结果 。 

Shirt.red.dry clean only.count 返回 的 是 red 和 dry clean only 综 
合 结果 的 数目 。 在 这 里 和 
Shirt.red.dry clean only.average(:thread count) 类 似 。 


scope 是 一 步 步 走 下 去 的 


class Person < ActiveRecord::Base 
has many :shirts 
end 


日 


假设 ，elton 是 Person 的 实例 对 象 ， 则 elton.shirts.red.dry clean only 返回 的 是 
elton( 限 制 条 件 ) 的 red fe dry clean only shirts. 


scope 后 可 直接 跟 extensions 


和 has many 类 似 的 : 


class Shirt « ActiveRecord::Base 
scope :red, -» ( where(color: 'red') ) do 


def dom id 
'red shirts' 
end 
end 


end 


scope 后 可 直接 跟 creating/building 等 方法 


用 于 创建 record 


class Article < ActiveRecord::Base 
scope :published, -> ( where(published: true) } 
end 


Article.published.new.published # => true 
Article.published.create.published # => true 


scope 后 可 直接 跟 类 方法 


定义 如 下 : 


class Article < ActiveRecord::Base 
scope :published, -> ( where(published: true) } 
scope :featured, -» ( where(featured: true) } 


def self.latest article 
order('published at desc').first 
end 


def self.titles 
pluck(:title) 
end 
end 


调用 如 下 : 


Article.published.featured.latest article 
Article.featured.titles 


default scope 


1) 一 个 参数 ， 需 要 以 proc 的 形式 定义 : 


class Article < ActiveRecord::Base 
default scope ( where(published: true) } 
end 


2) 始终 起 作用 ， 不 能 覆盖 ， 冲 突 时 取 合 集 。 
3) 会 影响 initialization 过 程 。 例 如 以 上 示例 ， 默 认 新 创建 的 对 象 published 为 true. 


4) 基于 第 2、3 点 请 惯用 。 


unscoped 


前 面 说 过 scope 可 以 链 式 调用 ， 但 如 果 调 用 了 unscoped 的 话 ， 它 可 以 把 之 前 的 
scope 给 清除 掉 ， 包 括 default scope. 


示例 : 


class Post < ActiveRecord::Base 
def self.default scope 
where published: true 
end 
end 


Post.all 
4 Fires "SELECT * FROM posts WHERE published - true" 


Post.unscoped.all 
4 Fires "SELECT * FROM posts" 


Post.where(published: false).unscoped.all 
f Fires SELECT SEROMSBOSES" 


all 


all Zik» AH scope’ 492 Relation 对 象 。 如 果 已 调用 了 别 的 scope 
方法 ， 则 没 必 要 使 用 它 ， 因 为 默认 返回 的 就 已 经 是 所 有 符合 条 件 的 数据 。 


为 什么 参数 要 是 proc 类 型 ? 


scope :recent, -> ( where("created at > ?", 2.day.ago) ) 
可 以 看 到 这 里 的 2.day.ago 是 动态 生成 的 ， 每 一 次 执行 的 时 候 才 知道 结果 。 不 
使 用 proc 类 型 的 话 ， 这 里 立即 执行 ， 就 和 想像 中 的 结果 不 同 了 。 


Note: 并 不 是 所 有 的 方法 都 可 以 做 为 scope 的 内 容 ， 更 多 内 容 Active Record 
Query Interface 


scope 可 以 调用 的 时 候 带 参数 


scope :find lazy, -> (id) ( where(:id => id) } 
# 带 默 认 值 


scope :recent_applies, ->(day=3){ where("created at > ?", day.da 
ys.ago) j 


注意 ， 使 用 后 不 能 再 进行 链 式 调用 。 


Attribute Methods 


TODO 


Attribute Methods x fF FHA 
提供 针对 某 属 性 的 读 写 方法 。 

主要 内 容 

常用 实例 方法 : 


[] 
加 = 


attributes 
attribute names 


attribute for inspect 


attribute present? 
has attribute? 


另外 对 某 个 属性 attribute， 其 它 相 关 模 块 还 会 提供 以 下 方法 : 


+ Read 


attribute 


un lly {on 
Wille 


attribute= 


Query 


attribute? 


BSE BAKE 


一 般 情 况 下 ， 如 果 要 履 盖 某 个 属性 的 读 写 方 法 的 话 ， 履 盖 的 通常 是 Read/Write 下 
的 方法 ， 也 就 是 : 


7-49 = 
AR xm HJ 


user.name 
user.name- 


Sy Te Be ce A sa £ AAS AI E b LL TE 
+ Vl T em JE Lm TE E. - 1% OR 25-47 Ja Se AAD 
^ 7 yz A A 二 1 IK AS Fl) Ja 3 1% a] 
f S (6 ANZ: V3 ZX sp EN DR ORY 18. 


user[:name] 
user[:name]- 


4% Enum 提供 的 enum 和 CarrierWave 提供 的 mount uploader 都 是 这 样 做 
的 。 
区 别 于 Active Model 下 的 Attribute Methods 


与 我 们 平常 使 用 到 的 读 写 方法 ， 没 有 直接 联系 。 


Read 


read attribute 根据 属性 名 ， 获 取 其 值 。 


和 self[:x] 等 价 


read attribute(:name) 


self[:name] 


self.name 


数据 从 attributes 里 获取 ， 不 同 于 直接 self.name CRR K GR SEHE o 


如 果 字 段 用 于 存储 图 片 信 息 ， 并 且 我 们 有 默认 图 片 ， 则 没有 图 片 时 : 
self.image 返回 的 是 默认 图 片 信 息 ， 而 self[:image] 返回 nil 3X XR 
实 信 息 ， 这 和 self.attributes 里 的 image 信息 一 致 。 


那 为 什么 不 用 attributes[:name] 而 用 read attribute[:name] ? 因为 性 
能 ， 前 者 要 把 所 有 的 属性 都 找 出 来 ， 然 后 取 name 属性 ; 而 后 者 可 以 直接 获取 
name 属性 。 


Write 


属性 名 ， 加 后 级 = 进行 赋值 。 


区 别 于 attr writer, 这 里 的 写 和 数据 库 操作 有 关 。 


Before Type Cast - 类 型 转换 
同样 的 数据 ， 每 个 数据 库存 储 多 少 有 一 点 不 同 。 我 们 ' 对 象 .属性 ' 或 ,类 .查询 ' 得 到 的 


数据 ， 未 汰 就 是 数据 库 里 存放 的 数据 (至 少 形 式 上 不 一 样 f): 上 述 两 点 ， 虽 然 差 异 不 
大 ， 但 多 少 还 是 要 经 过 处 理 的 。 


实例 方法 : 
read attribute before type cast 
X before type cast 


attributes before type cast 


举例 : 对 数字 和 时 间 ， 特 别 是 boolean 类 型 的 数据 , 数据 库 可 能 用 true/false, t/f, 
1/0, TIF 来 表示 ， 而 我 们 获取 的 只 有 一 种 true/false. 


class Task « ActiveRecord::Base 


end 

task.read attribute('id') # => 1 
task.read attribute before type cast('id') # => '1' 
task.read attribute('completed on') # => Sun, 2 
0c 2012 


task.read attribute before type cast('completed on') # => "2012- 
19-27” 
task.completed on before type cast('completed on') 4 => "2012- 
10-21" 


task.attributes 
# => {"id"=>nil, "title"=>nil, "is_done"=>true, "completed_on"=> 
Sun qm OG 2012; 

"created at"-»nil, "updated at"-»nil) 


task.attributes before type cast 
# => {"id"=>nil, "title"=>nil, "is_ done"=>true, “completed on"=> 
2912-19. 21. 

"created at"-»nil, "updated at'-z»nil) 


默认 ， 结 果 已 经 经 过 类 型 转换 。 但 有 时 候 我 们 也 不 希望 类 型 转换 ， 比 如 : 在 控制 台 
里 ， 对 于 ' 时 间 ' 不 转换 我 反而 觉得 更 易 读 。 


Query - 后 级 '?' 问 询 
加 后 级 '?' 进行 boolean 判断 。 


你 还 在 用 : 


<% if Quser.login.blank? %> 
<%= link to 'login', new session path %> 
«96 end %> 


+ 
4 


<% if Quser.login.present? %> 
<%= Quser.login %> 
<% end %> 


你 Out 1 > BH: 


<% unless Quser.login? 9 
<%= link to 'login', new session path 96» 
«96 end %> 


<% if Quser.login? 9» 
<%= Quser.login %> 
<% end %> 


每 一 个 record AERA 3627 HK > "E EAE AIT SUUS ER o 12 RERA SL 
X boolean 类 型 ， 其 它 类 型 的 判断 结果 有 时 候 会 和 想像 的 不 一 样 ， 请 惯用 。 不 要 为 
了 少 敲 几 个 字符 ， 增 加 犯错 的 几率 。 


原理 是 : 判断 其 值 是 否 为 false?、blank? 或 zero? 


sp 


4 status W integer 类 型 的 字段 ， 当 它 为 0 时 : 
self.status.present? => true 
self.status? => false 


Query - 后 级 '?' 问 询 
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Serialization 


serialize 指定 某 个 字段 的 存储 类 型 (默认 是 YAML) ° 


这 个 类 型 是 可 序列 化 的 ， 如 : Array > JSON ` Hash (此 时 请 注意 于 【Store】 的 
store 方法 的 区 别 ) 


使 用 举例 : 
class Post < ActiveRecord::Base 


serialize :title, Hash 
end 


# MUIR title 相当 于 Hash 的 名 字 


post = Post.new 
post.title 


EU 


post.title.class 
# Hash 


post.title = { name: 'Your Name.' } 
post.title[:name] 
4 -» Your Name. 


存储 时 ， 如 果 类 型 不 符合 ， 会 报错 。 


名 字 和 【ActiveRecord::Serialization】 相 同 ， 注 意 它 们 的 区 别 。 


Primary Key 
类 方法 : 
primary key 
primary key- 
primary key 主键 (又 称 主 关键 字 ) 。 


是 表 中 的 一 个 或 多 个 字段 ， 它 的 值 用 于 惟一 地 标识 表 中 的 某 一 条 记录 。 默 认 是 'id' 
属性 ， 一 般 不 会 更 改 。 


使 用 举例 : 
class Project < ActiveRecord::Base 


self.primary key - 'sysid' 
end 


class Project « ActiveRecord::Base 
def self.primary key 
"foo ' + super 
end 
end 


Project.primary key # => "foo id" 
除 上 述 类 方法 外 ， 还 有 类 方法 : 
dangerous attribute method? 


define method attribute 


quoted primary key 


和 实例 方法 : 


Id 

id- 

id? 

id before type cast 
id was 


to key 


Gy 


跟踪 对 象 值 的 变化 情况 。 

Active Model 有 同名 Dirty 模块 ， 这 里 是 对 它 的 使 用 ， 并 且 这 里 没有 对 外 提供 API. 
文档 可 以 参考 【Model 的 增强 模块 Dirty ] » 

IimeZ C 


TODO 


Persistence 


很 重要 的 模块 ， 提 供 保存 、 更 新 、 删 除 等 操作 。 


update & update attributes 
update! & update attributes! 
update attribute 

update column 

update columns 


delete 
destroy 
destroy! 


new record? 
persisted? 
destroyed? 


reload 


decrement 
decrement ! 
increment 
increment! 


Persistence 


toggle 
toggle! 


H 单 表 继承 时 ， 子 类 对 象 行为 表现 像 父 类 对 象 
becomes 
becomes! 


Note: 这 里 大 部 分 是 对 单个 对 象 的 操作 © 
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数据 更 新 方法 对 比 


持 
ii 使 用 默认 7 x g 更 新 Readonly 
Accessor? — , 3% 384 updated at 检查 
R? 
x= 是 € - - - - 
write attribute 个 € - - - - 
update attribute 是 是 T 是 是 是 
assign attributes 
& 是 € - - - - 
attributes- 
update & a a a a a a 
update_attributes s = is gs 
update column € 是 G 4 € 是 
update columns #& 是 G € € 是 
User::update 是 是 是 是 是 是 
User::update_all € 是 = B € © 


X= 表示 直接 赋值 ， 其它 几 个 是 方法 名 

write_attribute(:name, ?) 等 价 于 user[:name]= ? 

User::update 是 类 方法 ， 直 接 封 装 了 User#update 实例 方法 ， 效 果 是 一 样 的 。 
update & update attributes 封装 了 assign attributes 

update column 直接 封装 了 update columns 

参考 


Different Ways to Set Attributes in ActiveRecord 


对 比 ， 然 后 使 用 合适 的 方法 
e delete vs destroy 

前 者 不 会 触发 回调 ， 后 者 会 。 前 者 速度 更 快 。 
e delete all vs destroy all 

前 者 会 触发 回调 ， 后 者 不 会 。 前 者 速度 更 快 。 
e update column vs update attribute 

前 者 不 会 触发 校 验 ， 后 者 会 。 前 者 速度 更 快 。 


e update column/update attribute vs save 


前 者 更 新 部 分 ， 后 者 更 新 所 有 (并 且 要 运行 校 验 、 回 调 )。 前 者 速度 更 快 。 


e update all/find in batches vs for/each 
前 者 为 批量 操作 ， 后 者 不 是 。 前 者 速度 更 快 。 
e select vs 默认 查询 
前 者 指定 查询 部 分 字段 ， 后 者 查询 所 有 字段 。 前 者 速度 更 快 。 


e pluck and plucks vs map 


前 者 直接 指定 查询 部 分 字段 ， 后 者 查询 所 有 字段 然后 才 取 部 分 字段 。 


快 。 
e index vs 默认 查询 
前 者 借助 了 索引 ， 后 者 没有 。 前 者 速度 更 快 。 
e 原生 SQL vs AR 方法 
使 用 原生 SQL 比 使 用 ActiveRecord 方法 要 快 。( 不 解释 ) 
参考 


Rails-with-massive-data 


对 比 ， 然 后 使 用 合适 的 方法 
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多 个 save 方法 


在 以 下 几 个 类 或 模块 里 都 有 save 方法 ， 那 么 它 到 底 是 如 何 工 作 ， 如 何 保存 数据 的 
We, o 


module ActiveRecord 
class Base 
TROC 
4 HEAR create or udpate 
include Persistence 


Ho... 
# 70K perform validations 
include Validations 


HT 
# 相关 及 数据 Dirty 
include AttributeMethods 


d 

# mE3#% rollback active record state! & with transaction r 
eturning status 

include Transactions 


根据 Ruby 的 代码 执行 规则 : AR A MBIA 5] AMS > REBUT € it) save 7 
法 。 


A Transactions 的 save 
A AttributeMethods 的 save 
入 Validations 的 save 
入 Persistence 的 save 


离开 Persistence 的 save 
离开 Validations 的 save 


离开 AttributeMethods 的 save 
离开 Transactions 的 Save 


同 理 ， 当 执行 其 它 茶 个 操作 的 时 候 ， 也 会 发 生 类 似 情形 。 


Life of save in ActiveRecord 


Counter Cache 


值 。 


fi $ 37h HH 98 LAE 
# CATT XX 2s IE 


update counters(id, counters) 


# 下 面 这 两 个 方法 基于 update counters 
increment counter(counter name, id) 
decrement counter(counter name, id) 


# 当 计 数 出 错时 ， 可 用 它 来 校正 
reset_counters(id, *counters) 


按 要 求 加 减 指定 计数 器 的 值 、 统 计数 目的 加 一 、 统 计数 目的 减 一 、 重 置 计数 器 的 


这 几 条 命令 直接 转化 成 sql 语句 ， 所 以 性 能 上 要 比 普通 的 "给 对 象 的 计数 器 赋值 ， 然 


后 保存 对 象 " 要 快 ， 并 且 准 确 性 得 到 了 更 高 的 保证 。 


之 前 没有 统计 数目 ， 新 增 统计 数目 ， 或 之 前 的 统计 数目 存在 错误 ， 使 用 
reset counters 你 可 以 又 快 、 又 准确 的 得 到 统计 数目 。 


update counters(id, counters) 


计数 器 实现 。 在 它 基 础 上 通常 有 加 一 、 减 一 操作 ， 但 也 可 以 单独 使 用 。 考虑 到 并 
发 ， 这 里 并 不 只 是 Rails 层 面 的 get， 然 后 set。 而 是 在 SQL 层 面 " 丨 正 执行 时 " 才 增 量 


加 减 ( 但 没有 用 锁 机 制 )。 下 面 的 加 一 、 减 一 方法 都 是 这 样 。 


SIC o AH HL oc £v 4 
# ER! 参 效 二 字段 加 


Post.update counters 3, comments count: +1 


UPDATE "posts" SET "comments count" = COALESCE("comments count", 


9) + d Xn 
WHERE "posts"."id" = 3 


# 原来 没有 使 用 计数 器 ， 或 因为 菜 种 原因 计数 错误 。 现 在 我 们 要 使 用 或 修正 计数 器 。 


Post.update counters 3, comments count: post.comments.count 


ENS 





increment counter(counter name, id) 

给 counter name 字段 进行 加 一 。 

decrement counter(counter name, id) 

给 counter name 字段 进行 减 一 。 

reset counters(id, *counters) 

上 文 提 到 的 "新 增 计数 器 "， 也 可 用 此 方法 实现 。 


# 注意 : 参数 是 关系 表 名 (可 以 是 多 个 ) ， 而 不 是 字段 名 


Post.reset counters(3, :comments) 


SELECT "posts".* FROM "posts" WHERE "posts"."id" = ? LIMIT 1 
[["1d", 3]] 

SELECT COUNT(*) FROM "comments" WHERE "comments"."post id" - ? 
Ipost erdi el 

UPDATE "posts" SET "comments count" = 2 WHERE "posts"."id" = 3 


基于 SQL 层 面 ， 重 置 (理解 为 校正 ， 而 不 是 归 零 ) 一 个 或 多 个 计数 器 的 值 。 计 数 器 有 
时 候 会 不 准 ， 特 别 是 我 们 用 来 计数 关联 对 象 的 个 数 ， 而 自己 又 手动 删除 它们 。 


Note: counter cache 的 attribute 默认 是 read only 


Querying 


delegate :find, :take, :take!, :first, :first!, :last, :last!, 
exists?, :any?, 

:many?, to: :all 
delegate :second, :second!, :third, :third!, :fourth, :fourth!, 
inch, Such, 

:forty two, :forty two!, to: :all 
delegate :first or create, :first or create!, :first or initiali 
ze, to: :all 
delegate :find or create by, :find or create by!, :find or initi 
alize by, to: :all 
delegate :find by, :find by!, to: :all 
delegate :destroy, :destroy all, :delete, :delete all, :update, 
:update all, to: :all 
delegate :find each, :find in batches, to: :all 
delegate :select, :group, :order, :except, :reorder, :limit, :of 
fset, :joins, :where, 

:rewhere, :preload, :eager load, :includes, :from, :lock 
, :readonly, :having, 

:create with, :uniq, :distinct, :references, :none, :un 
scope, to: :all 
delegate :count, :average, :minimum, :maximum, :sum, :calculate, 
to: :all 
delegate :pluck, :ids, to: :all 


Blmm———————————————— —Ó«.[ 
RE delegate 方法 外 ， 还 有 : 
find by sql 


count by sql 


结合 ActiveRecord::Relationznone 可 以 用 来 表示 和 处 理 结果 为 空 的 Relation. 


Active Record 工具 


为 了 完成 某 项 任务 而 生 。 包 括 但 不 限于 : 
Transactions 事务 
e Validations 校 验 
包括 Associated Validator ` Presence Validator ` Uniqueness Validator. 
Store 
No Touching 
Readonly Attributes 
Nested Attributes #444 
Integration 
Inheritance # # 2k 
Enum 枚 举 
Callbacks 回调 
Attributes 
e Locking 
包括 Optimistic、Pessimistic 
Translatien 
有 多 个 模块 是 从 Base 抽取 而 来 ， 它 们 是 : Attribute Assignment ` Dynamic 


Matchers ^ Inheritance ` Integration ` Model Schema ` Querying ` Readonly 
Attributes ` Sanitization ` Scoping ` Translation 


Callbacks 回调 


基于 Action Model 提供 的 define_model_callbacks 和 Active Support 提供 的 
define callbacks 方法 ， 共 生成 十 几 个 过 滤器 方法 。 


‘Callbacks 


ActiveRecord: 
define_model_callbacks :initialize, :find, :touch, :only => :aft 
er 


define_model_callbacks :save, :create, :update, :destroy 


ActiveModel::Callbacks 


define callbacks :validation 


# ActiveRecord::Transactions 


define_callbacks :commit, :rollback 


fe AbstractController::Callbacks::ClassMethods 用 元 编程 生成 过 滤器 的 方法 名 ， 是 
两 种 手法 (尽管 最 终 都 是 基于 ActiveSupport::Callbacks). 


a 


通过 钧 子 的 方式 ， 影 响 对 象 的 生命 周期 。 


CALLBACKS - [ 
:after initialize, :after find, :after touch, 
:before save, :around save, :after save, 
:before create, :around create, :after create, 
:before update, :around update, :after update, 
:before destroy, :around destroy, :after destroy, 
:before validation, :after validation, 
:after commit, :after rollback, 


:after create commit, :after update commit, :after destroy com 
mit 


] 


怎么 使 用 ? 
调用 方式 主要 有 以 下 几 种 : 


1. 宏 定 义 的 方式 ， 后 面 跟 方 法 名 进行 调用 
2. 传递 一 个 可 回调 对 象 
3. 以 类 方法 的 形式 ， 传 递 一 个 block 


DL er E 
起 到 分 离 和 复 用 的 作用 ， 但 复杂 高 了 ， 并 且 有 其 它 实 现 手 法 可 替代 。 
#1 宏 定义 的 方式 ， 后 面 跟 方 法 名 进行 调用 
class Topic < ActiveRecord::Base 
before destroy :delete parents 


private 
def delete parents 
self.class.delete all "parent id = #{id}" 
end 
end 


回调 是 针对 单个 record 对 象 而 言 的 。 当 传递 给 回调 的 参数 是 一 个 实例 对 象 时 ， 把 当 
前 record 对 象 当 做 参数 ， 传 递 并 执行 实例 对 象 里 和 回调 同名 的 方法 。 创 建 实例 对 象 
的 时 候 ， 你 也 可 以 传递 参数 。 


#2 传递 一 个 可 回调 对 象 

class BankAccount < ActiveRecord::Base 
before save Encryptionwrapper ,new 
after_save Encryptionwrapper .new 
after initialize EncryptionWrapper.new 

end 


class EncryptionWrapper 
def before save(record) 


record.credit card number - encrypt(record.credit card numbe 


r) 


end 


def after save(record) 


record.credit card number - decrypt(record.credit card numbe 


r) 


end 


alias method :after initialize, :after save 


private 
def encrypt(value) 
4 Secrecy is committed 
end 


def decrypt(value) 
4 Secrecy is unveiled 
end 
end 


# 2 传递 一 个 可 回调 对 象 

class BankAccount < ActiveRecord::Base 
before save Encryptionwrapper.new("credit card number") 
after save Encryptionwrapper.new("credit card number") 
after initialize Encryptionwrapper.new("credit card number") 

end 


class Encryptionwrapper 
def initialize(attribute) 


Qattribute - attribute 
end 


def before save(record) 
record.send("#{@attribute}=", encrypt(record.send("#{@attrib 
ute}"))) 


end 


def after_save(record) 
record.send("#{@attribute}=", decrypt(record.send("#{@attrib 
ute}"))) 


end 
alias_method :after_initialize, :after_save 


private 
def encrypt(value) 
# Secrecy is committed 
end 


def decrypt(value) 
# Secrecy is unveiled 
end 
end 


#3 以 类 方法 的 形式 ， 传 递 一 个 block 
class Napoleon < ActiveRecord::Base 
before destroy ( logger.info "Josephine..." ) 
before destroy do 
4 some code 
end 


抽取 封装 回调 方法 


和 覆盖 方法 名 ， 重 新 定义 方法 内 容 (注意 : 这 里 定义 的 是 实例 方法 啊 ， 内 容 不 会 被 执 
行 ， 其 它 类 再 继承 才能 执行 !) 


# 1 
class Topic < ActiveRecord: :Base 

def before_destroy() destroy_author end 
end 


class Reply < Topic 
def before_destroy() destroy_readers end 
end 


# 2 
class PictureFileCallbacks 
def after destroy(picture file) 
if File.exist?(picture file.filepath) 
File.delete(picture file.filepath) 
end 
end 
end 


class PictureFile « ActiveRecord::Base 
after destroy PictureFileCallbacks.new 
end 


# 3 
class PictureFileCallbacks 
def self.after_destroy(picture_file) 
if File.exist?(picture_file.filepath) 
File.delete(picture_file.filepath) 
end 
end 
end 


class PictureFile < ActiveRecord: :Base 


after_destroy PictureFileCallbacks 
end 


怎么 取消 后 面 的 回调 ? 


在 方法 里 返回 false 


如 何 理解 around 


用 around save 举例 : 


def around save 
# AM before save ... 
yield # 执行 save 
# AM after save ... 


end 


一 个 生命 周期 为 一 个 事务 (BEGIN...COMMIT) 

如 果 没 有 特殊 操作 ， 一 个 生命 周期 里 ， 对 数据 库 的 操作 是 在 同一 个 “事务 "里 进行 
的 。 所 以 ， 如 果 中 间 的 失败 ， 返 回 false 那么 后 续 操 作 ， 其 至 前 面 的 操作 都 会 失 
败 。 


开发 里 ， 可 以 在 控制 台 或 日 志 里 查看 BEGIN...COMMIT 之 问 的 增删 查 改 语句 ， 确 
保 同 一 个 事务 里 您 的 操作 是 预期 的 。 


回调 及 其 顺序 
每 个 操作 ， 它 所 对 应 的 回调 ( 按 顺 序 来 的 ) 。 


创建 


before validation 
after validation 


before save 
around save 


before create 
around create 
after create 


after save 


after commit/after rollback 


更 新 


before validation 
after validation 


before save 
around save 


before update 
around update 
after update 


after save 


after commit/after rollback 


删除 


before_destroy 
around destroy 
after destroy 


after commit/after rollback 


save 7 create * update 
commit = create + update + destroy 自然 地 也 包含 了 save 在 内 。 


Note: 执行 create 和 update 操作 ， 都 会 触发 after save 回调 。 但 它 的 顺序 始 
终 在 after create 和 after update 之 后 。 即 使 在 model 里 它 定义 在 前 面 ， 效 果 
一 样 。 


after initialize 和 after find 


不 管 是 直接 new 或 其 它 途 径 ， 只 要 有 对 象 被 初始 化 ， 就 会 触发 after_initialize 1 
调 。 使 用 它 ， 可 以 避免 重 写 initialize 方法 。 

只 要 从 数据 库 里 查找 记录 ， 就 会 触发 after find 回调 。 并 且 ，after find 和 

after initialize 同时 定义 的 时 候 ，after find 优先 级 要 高 于 after. initialize. 


initalize fe find 只 有 after 回调 ， 也 就 是 after initialize 和 after find callbacks > & 
有 对 应 的 before* 回调 。 但 它 的 用 法 和 其 它 的 回调 一 样 : 


class User « ActiveRecord::Base 
after initialize do |user| 
puts "You have initialized an object!" 
end 


after find do [user | 
puts "You have found an object!" 
end 
end 


>> User.new 
You have initialized an object! 
=> #<User id: nil» 


>> User.first 

You have found an object! 

You have initialized an object! 
=> #<User id: 1» 


Note: 上 面 例 子 已 经 证 明 ， 从 数据 库 里 查找 记录 ， 也 会 有 新 的 对 象 创 建 ， 所 以 
会 有 initialize 过 程 。 


after touch 


对 对 象 执 行 touch 更 新 后 ， 都 会 运行 after_ touch 回调 方法 。 我 们 可 以 指定 其 内 


"Y 


Ae 


class User « ActiveRecord::Base 


after touch do [user | 


puts "You have touched an object" 


end 
end 


>> u = User.create(name: 'Kuldeep' ) 


=> #<User id: 1, name: "Kuldeep", 
created_at: "2013-11-25 12:17:49", updated_at: "2013-1 


1-25 12:17:49"> 


>> u.touch 
You have touched an object 
=> true 


在 belongs to 关联 里 ， 除 touch: 


作 。 


true 外 ， 使 用 after touch 可 以 做 更 多 的 操 


class Employee « ActiveRecord::Base 
belongs to :company, touch: true 
after touch do 
puts 'An Employee was touched' 
end 
end 


class Company « ActiveRecord::Base 
has many :employees 
after touch :log when employees or company touched 


private 
def log when employees or company touched 
puts 'Employee/Company was touched' 
end 
end 


>> @employee = Employee.last 
=> #<Employee id: 1, company_id: 1, 


created_at: "2013-11-25 17:04:22", updated_at: 


13-11-25 17:05:05"> 


# triggers Qemployee.company.touch 
>> @employee. touch 
Employee/Company was touched 

An Employee was touched 

=> true 


120 


Note: after touch 实际 上 运用 得 比较 少 。 执 行 touch 操作 ， 除 它 之 外 ， 还 会 触 


发 after commit 和 after rollback 回调 函数 。 


查看 某 个 记录 关联 的 回调 及 其 顺序 


VA save 举例 : 


after save :回调 1，: 回 调 2 


查看 某 个 记录 关联 的 回调 及 其 顺序 


a record. save callbacks.map( |c| puts c.raw filter }; 


save 回调 1 
save 回调 2 


save 回调 3 
save 回调 4 


执行 顺序 从 下 往 上 ， 所 以 回调 之 间 有 相同 内 容 的 话 ， 上 面 的 可 以 覆盖 下 面 的 。 但 如 
果 下 面 的 回调 执行 失败 的 话 ， 也 会 影响 到 上 面 的 。 


这 里 不 区 分 是 系统 生成 的 方法 (大 多 数 是 关联 时 就 带 有 ， 如 
autosave associated records ` belongs to counter cache ^ 
has many dependent) * Z E Xl] E 7E 3L 83 Zr i © 


用 :prepend 参数 可 以 更 改 回调 在 堆栈 里 的 顺序 ， 如 : 


class Foo < ActiveRecord::Base 
belongs to :bar, autosave: true 


before save :modify bar, prepend: true 
end 


在 这 里 ，autosave 在 modify bar 之 前 完成 ， 也 就 是 说 modify_bar 优先 级 高 。 


跳 过 回调 
主要 有 4 种 方式 : 


update_columns 和 update_column 
它们 都 是 直接 执行 SQL 语句 ， 不 会 触发 回调 方法 。 


使 用 举例 : 


user.update columns(last request at: Time.current) 


save(:validate => false) 
跳 过 Model 里 的 所 有 校 验 。 


skip_callback 
跳 过 某 个 回调 。 


使 用 举例 : 


class writer < Person 


skip callback :validate, :before, :check membership, if: 


self.age > 18 } 
end 


x_without_callbacks 
VA object.send(:x_without_callbacks) 跳 过 某 个 系列 的 回调 。 


使 用 举例 : 


object.send(:create without callbacks) 
object.send(:update without callbacks) 


-> { 


可 选 参 数 
On 


使 用 :on 指定 要 关联 的 事件 。 


class User < ActiveRecord::Base 
before validation :normalize name, on: :create 


# :on takes an array as well 
after validation :set location, on: [ :create, :update ] 


protected 
def normalize name 
self.name - self.name.downcase.titleize 
end 


def set location 
self.location - LocationService.query(self) 
end 
end 


:prepend 


class Topic < ActiveRecord: :Base 
has_many :children, dependent: destroy 


before_destroy :log children 


private 
def log_children 
# Child processing 
end 
end 


topic 已 经 被 删除 了 ， 没 办 法 log children > TAAA SUE : 


class Topic « ActiveRecord::Base 
has many :children, dependent: destroy 


before destroy :log children, prepend: true 


private 
def log children 
4 Child processing 
end 
end 


if f» :unless 


class Order « ActiveRecord::Base 
before save :normalize card number, if: :paid with card? 
end 


class Order « ActiveRecord::Base 
before save :normalize card number, if: "paid with card?" 
end 


class Order « ActiveRecord::Base 
before save :normalize card number, 
if: Proc.new { |order| order.paid with card? } 
end 


class Comment « ActiveRecord::Base 
after create :send email to author, if: :author wants emails?, 
unless: Proc.new ( |comment| comment.article.ignore comments 
T 


end 


after create 


after create J£ FLA > record 对 象 应 该 已 经 创建 并 保存 到 数据 库 了 。 但 实际 情 
况 却 并 非 总 是 如 此 ， 因 为 after. create 和 整个 创建 、 保 存 是 处 于 同一 个 生命 周期 的 
(共用 一 个 commit) ， 所 以 还 是 有 可 能 保存 失败 。 


HEM? 如 果 我 们 在 此 回调 需要 调用 了 相关 record 对 象 ， 并 且 认 为 它 已 经 保存 到 数 
据 库 了 。 例 如 用 户 创建 后 ， 即 刻 发 送 邮件 给 Ta， 即 使 是 异步 的 ， 也 有 可 能 会 报 找 不 

到 此 对 象 。 因 为 有 一 点 点 时 间 差 ，record 对 象 还 未 申 正 保存 到 数据 库 ， 但 已 经 被 当 

做 保存 数据 库 进 而 调用 了 。 


after commit on: :create 


使 用 它 ， 则 保证 了 record 对 象 已 经 站 正 被 保存 了 ， 人 保存 到 数据 库 。 似 乎 解决 了 上 壕 
问题 。 


HAAR? commit 里 不 能 写 和 commit 自己 的 代码 。 比 如 你 要 save 一 个 record 对 
象 ， 那 么 不 能 再 在 after commit on: :create 执行 和 save 有 关 的 操作 ， 如 果 违 反 
了 ， 就 会 陷入 死 循环 里 。 可 以 使 用 update_columns 等 不 会 触发 commit 的 方法 更 
新 自己 ， 或 者 你 save 其 它 对 象 。 


Nested Attributes #44 14 


提供 类 方法 accepts nested attributes for(*attr names) 


attr names 由 : —4- X 2 ^A IE (association name) 和 一 个 或 多 个 可 选 参数 
(option) 28 X, » 


只 接受 options : 


:allow destroy 
:reject if 

: limit 

:update only 


:limit 在 单个 record 构建 时 不 执行 ; 指 量 构建 时 ， 在 校 验 之 前 执行 ， 并 且 超 过 
限制 的 话 直 接 抛 错 误 。 实 际 项 目 中 ， 不 推荐 使 用 。 


žir Akg AlE Rails 会 自动 帮 你 定义 属性 的 写 方法 。 


1% l ir AN > 
ia sk x57 4X A5 
19] AN "pP AL INS 


def Z(association name) attributes-(attributes) 
assign nested attributes for #{type} association(:4[associatio 
n name), attributes) 


end 


association name 就 是 你 声明 的 属性 ， 例 如 : 


class Book < ActiveRecord::Base 
has one :author 
has many :pages 


accepts nested attributes for :author, :pages 
end 


生成 author attributes-(attributes) 和 pages attributes- 
(attributes) 


对 于 关联 对 象 ， 会 自动 设置 :autosave 


L3 = sey “on 
su dX LER In AX nu 
H 4e zx TAY 


reflection.autosave - true # Ex 


add autosave association callbacks(reflection) # 回调 在 上 





— 
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Ae RAR AY BIKAR 4n] p VAG  :allow destroy 来 设置 。 如 : 


class Member < ActiveRecord: :Base 

has_one :avatar 

accepts_nested_attributes_for :avatar, allow_destroy: true 
end 


member.avatar_attributes = { id: '2', destroy: '1' } 
member.avatar.marked for destruction? # => true 
member . save 

member.reload.avatar # => nil 


上 面 举例 是 一 对 一 ， 下 面 的 一 对 多 关系 类 似 : 


params = ( member: { 
name: 'joe', posts_attributes: [ 
{ title: 'Kari, the awesome Ruby documentation browser!' }, 
{ title: 'The egalitarian assumption of the modern citizen' 
tr 
{ title: '', _destroy: '1' } # this will be ignored 
] 
+} 


member = Member.create(params[:member]) 

member .posts.length # => 2 

member.posts.first.title # => 'Kari, the awesome Ruby documentat 
ion browser!' 

member.posts.second.title # => 'The egalitarian assumption of th 
e modern citizen' 
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为 了 处 理 这 种 情况 。 你 可 以 设置 :reject if : 


class Member « ActiveRecord::Base 
has many :posts 


accepts nested attributes for :posts, reject if: proc do |attr 
ibutes| 
attributes['title'].blank? 
end 
end 


params - ( member: ( 
name: 'joe', posts attributes: [ 
{ title: 'Kari, the awesome Ruby documentation browser!' }, 
{ title: 'The egalitarian assumption of the modern citizen' 


ty 
{ title: '' } # this will be ignored because of the :reject 
if proc 
] 
+} 


member = Member.create(params[:member]) 
member .posts.length # => 2 

member.posts.first.title # => 'Kari, the awesome Ruby documentat 
ion browser!' 
member.posts.second.title # => 'The egalitarian assumption of th 
e modern citizen' 


在 这 里 ， 效 果 和 上 面 使 用 destroy: '1' 有 类 似 之 处 。 


重 现 autosave 创建 过 程 


Book has many :pages 


reflection = Book. reflect on association(:pages) 
Book.send(:add autosave association callbacks, reflection) 


Book.reflect on all autosave associations 


update only - 解决 更 新 关联 对 象 时 的 困扰 


之 前 的 写法 : 


4 alias.rb 
class Alias « ActiveRecord::Base 
belongs to :user 
accepts nested attributes for :user 
end 


举例 : 更 新 关联 对 象 


# 传递 id 
Alias.first.user.name 

>> "Alice" 

Alias.first.update attributes( 


{ 

:user_attributes => { 
‘id => 1, 4 <- 77 
:name => "Bob" 

} 

}) 


Alias.first.user.name 
>> W Bob" 


# 外 键 用 的 是 传递 过 来 的 id 
Alias.first.user id 
>> 


# 不 传递 id 
Alias.first.update attributes( 


{ 


:user_attributes => { 
:name => "Bob" 


# 没有 传递 外 键 ， 则 会 先 删除 ， 然 后 重新 创建 关联 对 象 
Alias.first.user id 
5002 


上 述 情 况 ， 虽 然 文 档 上 已 经 写 明 了 。 但 这 违背 了 我 们 的 直觉 ， 建 议 加 上 
:update only 参数 。 


之 后 的 写法 : 


4 alias.rb 
class Alias « ActiveRecord::Base 
belongs to :user 


accepts nested attributes for :user, update only: true 
end 


update only 仅 作 用 于 单一 关系 ， 对 collection 使 用 无 效 。 


当然 ， 除 上 述 方 法 外 ， 还 有 解决 办 法 就 是 D 直接 获取 ， 然 后 操作 被 关联 的 对 象 作 。 
或 者 ， 直 接 通过 关联 对 象 进行 赋值 ， 然 后 保存 (利用 auto save 进行 自动 更 新 ) 。 


invert of 的 另 一 个 作用 accepts nested attributes for with Has-Many-Through 
Relations 


allow destroy 选项 的 使 用 [Rails] fields for ^ accepts nested attributes for 和 
此 方法 配套 使 用 的 是 fields for 方法 。 


Inheritance 单 表 继承 

单 表 继承 一 个 或 多 个 Model 继承 于 另 一 个 Model， 并 且 最 终 它们 用 的 是 同一 张 
表 o 

我 们 会 遇 到 这 样 的 情况 : 

Employee 有 manager 和 developer 

Computer 有 pc 和 mac 

有 时 候 ， 需 要 把 它 区 分 对 待 ; 有 时 候 ， 又 要 对 它们 一 视 同 仁 。 


设计 表 和 model 时 ， 用 得 比较 多 的 是 "两 张 类 似 的 表 ， 两 个 类 似 的 model" 还 是 "一 
张 表 ， 一 个 model， 一 个 用 于 标识 的 字段 "， 再 或 者 是 第 3 种 选择 ， 也 就 是 这 里 要 
讲 的 "STI( 单 表 继承 )"。 


一 般 说 来 ， 单 表 继承 通常 用 于 : 属性 一 样 ， 但 行为 不 一 致 。 


是 什么 ? 


单 表 ， 就 是 在 数据 库 你 只 需要 一 张 表 。 
继承 ， 就 是 你 的 model 之 间 存 在 着 继承 关系 。 


上 面 的 例子 中 : 

我 们 可 以 只 用 employees 表 ， 却 有 model Manager 和 model Developer， 它 们 都 
继承 于 Employee. 

我 们 可 以 只 用 computers 表 ， 却 有 model Pc fr model Mac， 它 们 都 继承 于 
Computer. 


选择 
1. 各 子 模块 属性 是 一 样 的 。 这 里 要 从 "面向 对 象 "的 角度 去 看 ， 而 不 是 简单 的 "属性 
一 样 ' 就 能 使 用 。 


2. 需要 把 这 些 子 模块 代表 的 数据 放 在 一 想 显示 或 者 说 做 聚合 吗 ? 如 果 需 要 的 话 ， 
那么 使 用 STI 是 比较 好 的 选择 。 因 为 从 性 能 上 来 说 ， 即 使 优化 做 得 再 好 ， 跨 表 
操作 ， 也 不 如 在 一 个 表 里 操作 ， 来 得 简单 、 高 效 。 


3. 和 第 4 条 有 点 类 似 ， 它 们 属性 是 一 样 的 ， 只 是 行为 不 一 致 而 锋 。 如 果 只 是 大 部 
分 属性 一 样 ， 那 么 可 以 考虑 一 下 "多 态 关联 "。 


实际 使 用 过 程 中 ， 单 表 继 承 在 某 些 方面 提供 了 方便 (比如 : 自动 设置 type)， 但 同时 
也 会 造成 脐 烦 (比如 : 多 个 model)。 同 样 的 ， 使 用 "两 张 类 似 的 表 ， 两 个 类 似 的 
model" 或 "一 张 表 ， 一 个 model， 一 个 用 于 标识 的 字段 "或 其 它 手段 ， 也 会 有 自己 的 


问题 。 


这 些 方法 都 有 利 有 商 ， 选 择 时 ， 我 们 尽量 选择 利 大 于 商 的 那 一 种 吧 。 


使 用 
单 表 继承 默认 使 用 type 做 为 标识 字段 ， 在 表 里 面 新 增 字段 即 可 ， 当 然 ， 也 可 以 
M [Model Schema】 里 的 inheritance column 自 定义 标识 字段 。 创 建 相应 对 
象 时 ， 会 根据 所 使 用 的 模块 名 自动 设置 它 的 值 。 

class Company < ActiveRecord::Base 

end 

class Firm « Company 

end 

class Client « Company 


+ 
Tr n:a 


end 


Transactions 事务 


transaction(options = {}, &block) 要 么 同时 成 功 ， 往 下 走 ; 要 么 同时 失 
Wo UR 


事务 是 恢复 和 并 发 控制 的 基本 单位 。 


事务 应 该 具有 4 个 属性 : 原子 性 、 一 臻 性、 隔离 性 、 持 久 性 。 这 四 个 属性 通常 称 为 
ACID 特性 。 


e 原子 性 (atomicity). 一 个 事务 是 一 个 不 可 分 割 的 工作 单位 ， 事 务 中 包括 的 诸 操作 
要 么 都 做 ， 要 么 都 不 做 。 

e 一 致 性 (consistency). 事务 必须 是 使 数据 库 从 一 个 一 致 性 状态 变 到 另 一 个 一 致 
性 状态 。 一 致 性 与 原子 性 是 密切 相关 的 。 

e [à à (isolation). 一 个 事务 的 执行 不 能 被 其 他 事务 干扰 。 即 一 个 事务 内 部 的 操 
作 及 使 用 的 数据 对 并 发 的 其 他 事务 是 隔离 的 ， 并 发 执行 的 各 个 事务 之 问 不 能 
相干 扰 。 

e 持久 性 (durability). 持久 性 也 称 永 久 性 (permanence)， 指 一 个 事务 一 旦 提交 ， 
它 对 数据 库 中 数据 的 改变 就 应 该 是 永久 性 的 。 接 下 来 的 其 他 操作 或 故障 不 应 该 
对 其 有 任何 影响 。 


使 用 举例 : 


ActiveRecord::Base.transaction do 
david.withdrawal(100) 
mary.deposit(100) 

end 


Rails 提供 的 事务 ， 可 以 做 为 类 方法 ， 也 可 以 做 为 实例 方法 进行 调用 。 
并 且 ， 一 个 事务 里 面 可 以 操作 多 个 对 象 : 


类 方法 
Account.transaction do 
balance.save! 
account.save! 
end 


balance.transaction do 
balance.save! 
account.save! 

end 


after commit(*args, &block) 和 after rollback(*args, &block) 使 用 
上 完全 一 样 。 
默认 commit 包括 : created, updated, 和 destroyed. 不 过 ， 你 可 以 用 可 选 参 数 


:on 指定 其 中 的 一 个 或 多 个 : 


after commit :do foo, on: :create 
after commit :do bar, on: :update 
after commit :do baz, on: :destroy 


after commit :do foo bar, on: [:create, :update] 
after commit :do bar baz, on: [:update, :destroy] 


原理 ， 和 普通 的 回调 类 似 。 使 用 Active Support 提供 的 set callback(name, 
*filter list, &block) 完成 。 


使 用 事务 后 ， 其 它 destroy ` save ` save! ` touch 等 操作 时 也 会 对 应 的 受到 影响 © 


E 
法 
% 
& 
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为 FEN (Pessimistic) fe KR W4 (Optimistic). 


EN Si (Pessimistic) 


特性 
强烈 的 独占 和 排他 。 

它 指 的 是 对 数据 被 外 界 ( 包 括 本 系统 当前 的 其 他 事务 ， 以 及 来 自 外 部 系统 的 事务 处 
理 ) 修 改 持 保守 态度 ， 因 此 ， 在 整个 数据 处 理 过 程 中 ， 将 数据 处 于 锁定 状态 。 
实现 


往往 依 千 数据 库 提供 的 锁 机 制 (也 只 有 数据 库 层 提供 的 锁 机 制 才 能 昊 正 保证 数据 访问 
的 排他 性 ， 和 否则 ， 即 使 在 本 系统 中 实现 了 加 锁 机 制 ， 也 无 法 保证 外 部 系统 不 会 修改 
数据 ) 。 


一 个 典型 的 依赖 数据 库 的 悲观 锁 调 用 : 


select * from account where name="Erica" for update; 


这 条 sql 语句 锁定 了 account 表 中 所 有 符合 检索 条 件 (name="Erica") 的 记录 。 本 次 
事务 提交 之 前 (事务 提交 时 会 释放 事务 过 程 中 的 锁 )， 外 界 无 法 修改 这 些 记录 。 


注意 : 根据 name 是 否 有 索引 、 是 否 是 唯一 索引 、 是 否 是 主键 ， 决 定 锁 全 表 、 
区 间 、 单 个 记录 。 
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相关 方法 有 : lock ^ lock! 和 with lock. 

# F > lock 和 with lock 都 是 封装 lock! 而 来 。 


lock 相当 于 lock! 的 别名 ， 但 调用 者 可 以 是 relation 对 象 。 
with lock 和 事务 捆绑 在 一 起 ， 并 且 参 数 可 以 是 代码 块 。 


使 用 举例 : 


# 使 用 lock， 注 意 生 成 的 SQL 

Account.lock.find(1) 

# SELECT accounts .* FROM accounts WHERE accounts . id = 1 
LIMIT 1 FOR UPDATE 


# lock 结合 transaction 一 起 使 用 
Account ,transaction do 


4 select * from accounts where name = 'shugo' limit 1 for upda 
te 

shugo = Account.where("name = 'shugo'").lock(true).first 

yuko = Account.where("name = 'yuko'").lock(true).first 


shugo.balance -= 100 
shugo. save! 
yuko.balance += 100 


yuko. save! 
end 
# 使 用 lock! 


Account.transaction do 
# select * from accounts where 
accounts = Account.where(...) 
accounti = accounts.detect { |account| ... } 
account2 = accounts.detect { |account| ... } 


4 accounti 和 account2 只 能 是 单个 对 象 
# Select * from accounts where id=? for update 
accounti.lock! 
account2. lock! 
accounti.balance -= 100 
accounti.save! 
account2.balance += 100 
account2.save! 
end 


4 使 用 with lock! 
account - Account.first 


# account 加 上 了 锁 ， 代 码 块 加 上 了 事务 


account.with lock do 
account.balance -- 100 
account.save! 

end 


使 用 注意 


1) 锁 表 ， 一 个 地 方 执行 写 的 时 候 ， 另 一 个 地 方 不 能 同时 执行 写 操作 ， 这 没 问 题 。 但 
问题 是 ， 你 也 不 能 执行 读 操作 。 


2) 一 个 地 方 读 数据 ， 并 赋值 给 对 象 。 另 一 个 地 方 在 这 之 后 执行 了 写 操作 ， 这 个 对 象 
( 脏 数据 ) 会 覆盖 已 经 更 新 过 的 数据 ， 而 不 是 报错 。 


Note: 它 是 数据 库 级 别 的 锁 。 


ANA (Optimistic) 


特性 


乐观 锁 (Optimistic Locking) 相对 悲观 锁 而 言 ， 乐 观 锁 机 制 采 取 了 更 加 宽松 的 加 锁 机 
制 。 

悲观 锁 大 多 数 情况 下 依靠 数据 库 的 锁 机 制 实现 ， 以 保证 操作 最 大 程度 的 独占 性 。 但 
随 之 而 来 的 就 是 数据 库 性 能 的 大 量 开 销 ， 特 别 是 对 长 事务 而 言 ， 这 样 的 开销 往往 无 
法 承受 。 而 乐观 锁 机 制 在 一 定 程度 上 解决 了 这 个 问题 。 


实现 
大 多 是 基于 数据 版 本 (Version) 记 录 机 制 实现 。 


何谓 数据 版 本 ? 即 为 数据 增加 一 个 版 本 标识 ， 在 基于 数据 库 表 的 版 本 解决 方案 中 ， 

一 般 是 通过 为 数据 库 表 增加 一 个 "version" 字段 来 实现 。 读 取出 数据 时 ， 将 此 版 本 

号 一 同 读 出 ， 之 后 更 新 时 ， 对 此 版 本 号 +1. 此 时 ， 将 提交 数据 的 版 本 数据 与 数据 库 
表 对 应 记录 的 当前 版 本 信息 进行 比 对 ， 如 果 提 交 的 数据 版 本 号 大 于 数据 库 表 当前 版 
本 号 ， 则 了 予以 更 新 ， 否 则 认为 是 过 期 数据 。 


Rails 的 乐观 锁 


使 用 举例 : 


1) 给 表 添 加 :lock version 属性 。 


add column :products, :lock version, :integer, :default => 0, :n 
ull => false 


2) 在 表单 里 使 用 此 属性 。( 此 处 略 ) 


3) 已 经 生效 。 如 果 更 新 的 是 脏 数 据 ， 会 报错 StaleObjectError ， 可 根据 这 个 做 
相应 处 理 。 


pi = Product.find(1) 

p2 = Product.find(1) 
pi.name = "Michael" 
pi.save 

p2.name - "should fail" 
p2.save 
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# 如 果 别 人 想 再 次 更 改 ， (Az 数据 ) 不 会 复生 已 经 更 新 过 的 数据 ， 而 是 会 报错 。 


# => Raises a ActiveRecord::StaleObjectError 


更 改 约 定 : 

1) 默认 标识 字段 是 lock_version ， 当 包含 此 属性 时 ， 按 照 约定 乐观 锁 会 "自动 生 
效 "。 有 时 候 ( 比 如 : 遗留 项 目 已 经 使 用 此 字段 ， 但 却 不 是 用 于 " 锁 ")， 我 们 可 能 需要 
拒绝 "自动 生效 "， 可 以 配置 : 


ActiveRecord::Base.lock optimistically = false 


# 或 ， 只 针对 某 个 model 
ClassName.lock optimistically = false 


2) 可 以 用 locking column 更 换 默 认 的 标识 字段 ， 如 : 


class Person < ActiveRecord::Base 
self.locking column - :lock person 


end 


Locking 


Note: 它 是 应 用 级 别 的 锁 。 
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Enum 枚 举 
元 编程 生成 一 系列 的 方法 : 
definitions.each do |name, values| 
klass.singleton class.send(:define method, name.to s.pluralize 
define_method("#{name}=") 
define_method(name) 
define_method("#{name}_before_type_cast") 
pairs.each do |value, i| # pairs 的 等 于 values 
define_method("#{value}?") 


define_method("#{value}!") 
klass.scope value 


假设 ， 我 们 有 status 字段 ， 使 用 enum 后 会 生成 什么 方法 ? 


class Post < ActiveRecord::Base 
enum status: [ :active, :archived ] 
end 


一 


同名 类 方法 (复数 形式 ) 


Post.statuses 
4 => {"active"=>0, "archived"=>1} 


2 5j value 同名 的 scope 方法 


Post.active 
# => SELECT "posts".* FROM "posts" WHERE "posts"."status" = 0 


3 value? 询问 是 否 为 某 值 


post.active? 
-» false 


4 value! 更 新 为 某 值 


post.active! 


begin transaction 
UPDATE "posts" SET "status" = ?, "updated at" = ? ^n 
WHERE "posts "xg = 2 [["status", 0], 
["updated at", "2014-04-20 09:06:53.7 
22202"1] 
commit transaction 
-» true 


5 同名 实例 方 法 (get 类 型 ) 


post.status 
=> "active" 


注意 : 此 处 这 里 如 果 用 post[:status] 的 方式 获取 属性 值 ， 返回 的 值 和 数据 库 
中 保存 的 一 样 ， 是 数字 。 


6 同名 实例 方法 = (set 类 型 ) 


post.status = "archived" 
=> "archived" 


注意 : 此 处 一 定 要 区 别 于 post[:status]= 设置 属性 值 。 


7 同名 实例 方法 (get 类 型 ) 


post.status before type cast 
-» "archived" 


注意 enum 的 字段 在 数据 库 保 存 的 是 integer 类 型 ， 但 在 外 表现 的 却 是 字符 串 ， 我 
们 查询 、 更 新 的 都 以 字符 囊 的 形式 进行 。 
另外 : 


注意 enum 生成 的 类 方法 、 实 例 方法 不 要 与 Active Record 提供 的 方法 ， 及 同一 个 
Model 下 其 它 enum 生成 的 方法 有 重复 。 


每 个 Model 下 面 都 会 有 一 个 叫 defined enums 的 变量 用 来 记录 enum 相关 信 


息 。 
读 取 、 设 置 某 属性 的 值 ， 通 常 有 两 种 方式 : 


user . name 
user .name= 


user [:name] 
user [:name]- 


一 般 情 况 下 ， 它 们 的 值 是 一 样 的 。 但 这 里 的 Enum 打开 了 user.name 和 
user.name= 方法 ， 变 换 了 返回 结果 ， 这 会 导致 两 者 的 值 不 一 样 。 


另外 ， 要 注意 当 使 用 update 更 新 多 个 属性 的 时 候 ， 操 作 的 是 数字 ， 而 非 字 符 
串 。 同 理 ， 使 用 where 查询 多 个 属性 的 时 候 ， 操 作 的 是 数字 ， 而 非 字符 囊 。 


Store 


store(store attribute, options = (1) 以 JSON( 也 可 以 理解 为 Hash) 的 形 
式 存储 某 字 段 。 


举例 ， 我 们 数据 库 里 有 name 字段 ， 我 们 想 这 样 存储 : 
name = ( last name: "Kelby", first_name: "Lee" } 
class User « ActiveRecord::Base 


store :name, accessors: [ :last name, :first name ], coder: JS 
ON 


end 

u = User.new(last name: 'Kelby', first name: 'Lee') 
u.last name # 直接 读 / 写 key 

u.name[:last name] = 'zk' # 通过 store 的 属性 来 读 / 写 key 

# 通过 store 的 属性 来 读 / 写 时 ，Kkey 类 型 可 以 是 Symbol 或 String 


u.settings[:last name] # => 'zk' 
u.settings['last name'] # => 'zk' 


store W& [Serialization] 4&9 serialize 和 下 面 的 store accessor 两 方法 


组 成 。 
store accessor(store attribute, *keys) 给 已 经 存在 数据 的 store 添加 


key. 


class User « ActiveRecord::Base 
store accessor :name, :nickname 
end 


它 主要 是 增加 了 和 key 同名 的 读 / 写 (实例 ) 方 法 。 


stored attributes 查询 一 个 字段 有 哪些 可 用 的 key. 


User.stored attributes[:name] # [:last name, :first name, :nickn 
ame] 


Note: 通过 store 的 属性 来 读 / 写 key， 这 里 的 key 可 以 不 在 accessors 范围 
里 。 如 果 不 在 范围 里 ， 则 不 能 直接 读 / 写 key， 并 且 stored attributes 查看 不 
到 o 


存 数组 用 上 一 章节 【AttributeMethods Serialization) 2 serialize 方法 


class Comment < ActiveRecord::Base 
serialize :stuff 
end 


comment = Comment.new # stuff: nil 
comment.stuff = ['some', 'stuff', 'as array'] 
comment . save 

comment.stuff # => ['some', 'stuff', 'as array'] 


Validations #& 4 
和 Active Model 里 的 校 验 实现 原理 类 似 ， 但 有 一 点 不 同 : 这 里 校 验 的 属性 要 是 关联 
对 象 或 要 从 数据 库 ' 读 ' 数 据 。 
1) validates associated(*attr names) 
校 验 是 否 存 在 关联 (关系 )。 可 以 同时 校 验 多 个 关联 (关系 ) 
class Book < ActiveRecord::Base 


has_many :pages 
belongs to :library 


validates associated :pages, :library 
end 


2) validates presence of(*attr names) 
校 验 (数据 库 里 ) 是 否 存在 着 关联 对 象 。 
3) validates uniqueness of(*attr names) 


校 验 属性 的 值 是 否 唯一 。 黑 认 是 对 所 有 record 进行 校 验 ， 可 以 用 scope 或 
conditions 指定 约束 条 件 。 


class Person « ActiveRecord::Base 
validates uniqueness of :user name 
end 


# 加 scope 约束 条 件 
# 同一 account 的 person, user name 不 能 相同 
# 不 同 account 的 person, user name 可 以 相同 
class Person < ActiveRecord::Base 
validates uniqueness of :user name, scope: :account id 
end 


# 加 conditions 约束 条 件 
4 status 为 archived 的 article* title 不 能 相同 
4 status 为 其 它 值 的 article» title 可 以 相同 
class Article < ActiveRecord::Base 
validates uniqueness of :title, conditions: -» ( where.not(sta 
tus: 'archived') } 
end 


同名 实例 方法 : 


save 
save! 


valid? & validate 


这 里 的 save 是 对 Persistence( 持 久 化 ) 里 的 save 方法 做 的 一 层 包 装 ， 在 "保存 "之 
前 用 来 做 校 验 工作 ， 并 不 是 趴 正 的 保存 操作 。 当 传递 validate: false 时 ， 可 
以 跳 过 此 校 验 。 其 它 同 名 实例 方法 意义 类 似 。 


Secure Token 


提供 has secure token(attribute = :token) 类 方法 


class User « ActiveRecord::Base 
has secure token 
has secure token :auth token 
end 


使 用 它 可 以 给 某 些 属性 赋值 SecureRandom::base58 长 度 的 字符 串 。 


默认 约定 使 用 token 属性 ， 并 生成 了 对 应 的 regenerate token 方法 : 


user = User.new 
user.save 


user.token # => "pX27zsMN2ViQKtaibGfLmVJE" 
user.auth token # => "77TMHrHJFvFDwodq8w7Ev2m7" 


内 部 实现 : 


通过 before create 及 属性 自 带 的 读 写 方 法 完成 赋值 操作 ; 
不 按照 约定 来 ， 后 续 也 可 以 更 改 属性 名 。 可 用 元 编程 生成 的 regenerate_# 
(attribute) 方法 进行 更 改 属 性 值 : 


user.regenerate token # => true 
user.regenerate_auth_token # => true 


Integration 


实例 方法 : to param 


Bik? Rails 生成 URL 时 用 的 是 primary key ， 也 就 是 数据 库 里 的 id 属性 。 
例如 : 


user = User.find by(name: 'Phusion') 
user path(user) # => "/users/1" 


这 对 于 SEO 和 人 类 识别 都 不 是 很 友好 。 我 们 可 以 重 写 toparam 方法 ， 设 置 更 
友好 的 内 容 : 


class User < ActiveRecord::Base 
def to param # overridden 
name 
end 
end 


user - User.find by(name: 'Phusion') 
user path(user) # => "/users/Phusion" 


实例 方法 : cache key(*timestamp names) 


返回 一 个 能 够 标识 对 象 的 字符 串 : 


Product.new.cache key # => "products/new" 
Product.find(5).cache_key # => "products/5" (updated_at not avai 
lable) 

Person.find(5).cache key # => "people/5-20071224150000" (update 
d_at available) 


当 我 们 需要 缓存 的 地 方 很 多 时 ， 黑 认 生 成 字符 串 的 规则 可 能 满足 不 了 我 们 的 需求 。 
我 们 可 以 传递 参数 给 它 ， 用 新 的 规则 生成 字符 串 : 


Person.find(5).cache key(:updated at, :last reviewed at) 


类 方法 : to param 


功能 上 和 实例 方法 to param 一样， 使 用 举例 : 


class User < ActiveRecord::Base 
to param :name 
end 


user - User.find by(name: 'Fancy Pants') 
user.id # => 123 
user_path(user) # => "/users/123-fancy-pants" 


No Touching 
常用 方法 : 


no touching 


使 用 举例 : 


ActiveRecord::Base.no touching do 
Project.first.touch # 不 会 执行 touch 
Message.first.touch # 不 会 执行 touch 

end 


Project.no touching do 
Project.first.touch # 不 会 执行 touch 


Message.first.touch # 会 对 message 执行 touch; 42% touch: true 
的 关联 对 象 不 会 被 touch 
end 


除 上 述 外 ， 还 有 方法 : 
no touching? 
touch 


# 优先 级 大 于 Persistence 里 的 touch 同名 方法 ; 


# 如 果 no touching? => true 则 不 调用 Persistence 里 的 touch 方法 。 


Touch Later 


提供 touch later 方法 。 


原来 的 touch 是 一 步 到 位 ， 更 新 updated at 并 保存 进 数 据 库 。 
使 用 touch later 后 ， 操 作 分 为 了 两 步 : 1) 更 新 updated at 2) 保存 进 数据 
Bo 


通常 的 ， 它 和 事务 (transaction) 一 起 使 用 ， 或 者 是 belongs to 并 touch 关联 对 象 。 


Attributes 
提供 方法 : 
attribute 


define attribute 


下 面 主要 讲解 attribute 方法 。 
1) 履 盖 原 有 类 型 的 行 ; 
使 用 举例 : 
# db/schema.rb 
create table :store listings, force: true do |t| 


t.decimal :price in cents 
end 


4 app/models/store listing.rb 
class StoreListing < ActiveRecord::Base 
end 


store listing = StoreListing.new(price in cents: '10.1') 


4 before 
store listing.price in cents # => BigDecimal.new(10.1) 


class StoreListing < ActiveRecord::Base 
attribute :price in cents, Type::Integer.new 
end 


# after 
store listing.price in cents # => 10 


2) 重新 定义 类 型 


使 用 举例 : 


class MoneyType < ActiveRecord: : Type: :Integer 
# 新 类 型 需 实现 type cast 方法 


def type cast(value) 


if value.include?('$') 


price in dollars 


value.gsub(/\$/, 


price_in_dollars * 100 


else 
value.to_i 
end 
end 
end 


class StoreListing < ActiveRecord: :Base 


attribute :price_in_cents, MoneyType.new 


end 


SPON 


store listing = StoreListing.new(price in cents: '$10.00') 
store listing.price in cents # => 1000 


Note: 履 盖 或 重新 定义 新 的 类 型 ， 也 许 并 不 是 好 的 实践 ， 使 用 之 后 会 遇 到 新 


问题 。 


A 


H 


E) 


Readonly Attributes 


提供 方法 : 
attr readonly 
readonly attributes 


attr readonly fe# attr x 类 似 ， 只 不 过 这 里 设置 的 是 某 属性 为 只 读 。 注 意 ， 
这 里 不 是 校 验 ， 所 以 保存 出 错 的 话 ， 不 会 放 到 record 对 象 的 errors 里 。 


Suppressor 


某 个 类 使 用 suppress FHKE? SHE block 里 的 保存 (save) 操 作 进 行 处 理 。 


这 里 影响 的 是 同类 型 的 实例 对 象 ， 无 论 是 新 建 、 更 新 操作 表面 上 都 执行 了 ， 但 实际 
上 没有 执行 。 


user = User.create! token: 'asdf' 


User.suppress do 
user.update token: 'ghjkl' 
assert equal 'asdf', user.reload.token 


user.update! token: 'zxcvbnm' 
assert equal 'asdf', user.reload.token 


user.token - 'qwerty' 
user.save 
assert equal 'asdf', user.reload.token 


user.token - 'uiop' 

user.save! 

assert equal 'asdf', user.reload.token 
end 


expand hash conditions for aggregates 


sanitize conditions & sanitize sql & sanitize sql for conditions 


sanitize sql array 


sanitize sql for assignment 


sanitize sql for order 


sanitize sql hash for assignment 





sanitize sql like 


Associations 关联 


Associations 文件 下 
4 个 关联 类 方法 -- (1) 


Associations 目录 下 -- 实现 几 个 关联 方法 。 
# 7 Buildeı | 
builder -- (2) 
HasAndBelongsToMany 
Association 
SingularAssociation 
HasOne 
BelongsTo 
CollectionAssociation 
HasMany 
4 个 关联 类 方法 ， 直 接 调 用 它们 
11 - Association 
Association -- (3) 
SingularAssociation --(3) 
HasOneAssociation 
HasOneThroughAssociation 
include ThroughAssociation 
BelongsToAssociation 
BelongsToPolymorphicAssociation 
CollectionAssociation --(3) 
HasManyAssociation 
HasManyThroughAssociation 
include ThroughAssociation 
ThroughAssociation -> HasOneThroughAssociation + HasManyThro 
ughAssociation 
ForeignAssociation -> HasOneAssociation + HasManyAssociation 


CollectionProxy(*) -» CollectionAssociation 
继承 于 Relation 


AssociationScope -> CollectionAssociation + SingularAssociat 
ion + Association 


JoinDependency(£3L joins) -> FinderMethods + QueryMethods 
JoinPart 
JoinBase 
JoinAssociation 


AliasTracker -> AssociationScope + JoinDependency 


Preloader --(#L includes, preload, eager load) 
ThroughAssociation 
Association 
CollectionAssociation 
HasMany 
HasManyThrough 
include ThroughAssociation 
SingularAssociation 
BelongsTo 
HasOne 
HasOneThrough 
include ThroughAssociation 


Aggregations 
AutosaveAssociation 


Ref lectio Ç 
AbstractReflection 
ThroughReflection 
PolymorphicReflection 
MacroReflection 
AggregateReflection 
AssociationReflection 
HasManyReflection 
HasOneReflection 
BelongsToReflection 
HasAndBelongsToManyRef lection 


Active Record 关联 
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Associations 文件 -4 个 关联 方法 
Association 提供 我 们 4 个 常用 方法 : 


has_many 

has_one 

belongs to 

has and belongs to many 


其 实现 步骤 
步骤 一 
调用 对 应 的 Builder’ € Builder, W2 Builder ...( 交 又 进行 的 ) 


步骤 二 : 


le] - 


调用 对 应 的 Reflection’ & Reflection， 再 父 Reflection’ MA Reflecti 
..( 交 又 进行 的 ) 


通过 association (由 最 初 的 Association 提供 ) 调用 对 应 的 Association 
提供 的 方法 ... (交叉 进行 的 ) 


关于 association 方法 


， 对 内 部 实现 来 说 非常 重要 的 实例 方法 : 


association(name) 


调用 对 应 Association 提供 的 方法 。 


通过 它 
通过 它 调用 CollectionProxy 提供 的 方法 。 


Associations 文件 -4 个 关联 方法 
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Aggregations - composed of 方法 


我 们 在 一 张 表 里 有 几 个 类 似 字 段 ， 比 如 customers KA address street, 

address city 字段， 用 于 保存 地 址 信息 。 好 的 做 法 ， 当 然 是 把 它们 拆 分 出 来 ， 单 独 
做 成 address 表 。 但 如 果 我 们 不 想 /能 折 分 表 成 的 话 (改动 太 大 ， 处 理 遗 留 问 题 等 ) ， 
使 用 composed of 可 以 实现 不 用 丨 正 折 分 表 ， 又 能 起 到 到 分 离 的 作用 。 


class Customer < ActiveRecord::Base 

composed of :address, mapping: [ 9?w(address street street), %w 
(address city city) ] 
end 


iX Y. > je address 当做 关联 对 象 。 原 customer 的 address street 和 address city 
分 别 映射 成 为 address 的 street 和 city 属性 。 


根据 "约定 优 于 配置 "， 关 联 对 象 address 对 应 class Address， 我 们 实现 它 : 


class Address 
attr reader :street, :city 


def initialize(street, city) 
Qstreet, @city = street, city 


end 
end 


之 后 即 可 对 Address 的 实例 对 象 进行 操作 © 


如 何 使 用 ? 


Customer 有 balance > address street ^ address city 字段 。 


class Customer « ActiveRecord::Base 
# 把 balance 当做 关联 对 象 ，amount 映射 成 为 它 的 属性 ; 对 应 着 class Money 


composed of :balance, class name: "Money", mapping: %w(balance 
amount ) 


4 把 address 当做 关联 对 象 ，street 和 city 映射 成 为 它 的 属性 ; 对 应 着 cl 
ass Address 

composed of :address, mapping: [ %w(address_street street), %w 
(address city city) ] 
end 


EEE , , ,KEz, 


可 选 参数 :class name, :mapping, :allow nil, :constructor, 
:converter ， 此 外 ， 你 有 下 列 读 、 写 方法 : 


# reader method(name, class name, mapping, allow nil, constructo 


r) 


4 writer method(name, class name, mapping, allow nil, converter) 


Customer#balance, Customer#balance=(money ) 
Customer#address, Customer#address=(address) 


除了 读 、 写 方法 外 ，composed of 还 创建 管理 了 Reflection 关联 两 者 : 


reflection = ActiveRecord::Reflection.create(:composed of, part 
id, nil, options, self) 
Reflection.add_aggregate_reflection self, part_id, reflection 


注意 : 我 们 没有 model Money 和 model Address， 也 没有 它们 对 应 的 表 ， 所 以 要 
实现 其 对 应 的 class? KM: 


class Money 
include Comparable 
attr reader :amount, :currency 
EXCHANGE RATES = ( "USD TO DKK" => 6 } 


def initialize(amount, currency - "USD") 
Qamount, Qcurrency - amount, currency 
end 


def exchange to(other currency) 
exchanged amount - (amount * 
EXCHANGE RATES["Z(currency) TO Z(other c 
urrency}"]).floor 
Money.new(exchanged amount, other currency) 
end 


def --(other money) 
amount -- other money.amount && currency -- other money.curr 
ency 
end 


def «-»(other money) 
if currency -- other money.currency 
amount «-» other money.amount 
else 
amount «-» other money.exchange to(currency).amount 
end 
end 
end 


class Address 
attr reader :street, :city 


def initialize(street, city) 
@street, @city = street, city 
end 


def close to?(other address) 
city -- other address.city 
end 


def --(other address) 
city -- other address.city && street -- other address.street 
end 
end 


Aggregations - composed of 方法 


# 关键 点 
class ClassName 
attr reader :attri, :attr2 


def initialize(attri, attr2) 
@attri, Qattr2 = attri, attr2 
end 
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customer = Customer.new 


customer.balance 
=> #<Money:0x007f8dabd8c940 @amount=nil, @currency="USD"> 


4 实例 化 customer % balance 关联 对 象 
customer.balance = Money.new(20) # sets the Money value objec 
t and the attribute 


customer.balance # => Money value object 
customer .balance.amount # => 20 

customer .balance.currency # => "USD" 

customer .balance.exchange_to("DKK") # => Money.new(120, "DKK" ) 
customer.balance > Money.new(10) # => true 

customer.balance == Money.new( 20) # => true 

customer.balance < Money.new(5) # => false 

# 还 有 

customer.address street = "Hyancintvej" 

customer.address city = "Copenhagen" 

4 实例 化 customer 的 address 关联 对 象 

customer.address # => Address.new("Hyancintvej", "Copenha 


gen") 
customer.address.street # => "Hyancintvej" 
customer.address.city # => "Copenhagen" 


customer.address_street = "Vesterbrogade" 

customer .address # => Address.new("Hyancintvej", "Copenha 
gen") 

customer.clear aggregation cache 

customer.address # => Address.new("Vesterbrogade", "Copen 
hagen") 


customer.address = Address.new("May Street", "Chicago") 
customer.address_street # => "May Street" 
customer.address city # => "Chicago" 


参考 一 下 has one > ik composed of ZH R Z 3€ AF » 4$ fl has one 和 
composed of， 两 张 表 均 属 于 一 对 一 关系 ， 只 不 过 composed of 是 我 们 想像 出 来 
MR HAR HE ASE) BEER o 


Note: composed of 创建 的 是 ' 值 对 象 '， 区 别 于 一 般 的 ' 实 体 对 象 '。 值 对 象 没有 
唯一 身份 标识 ， 只 有 所 有 的 值 相 等 ， 两 个 值 对 象 才 相 等 ; 而 实体 对 象 ， 有 唯一 
标识 (如 : id)， 只 要 唯一 标识 相等 ， 两 个 实体 对 象 就 相等 了 。 


可 选 参数 详解 


class name ”和 其 它 关联 一 样 ， 可 以 指定 类 名 


日 字段 与 新 字段 的 映射 关系 
日 字段 在 前 ， 新 字段 在 后 
被 关联 的 对 象 ， 其 属性 全 部 为 空 时 ， 这 个 被 关联 的 对 象 是 否 为 
allow_nil nil 对 象 
默认 选项 为 false 
constructor 如何 初始 化 值 对 象 


converter 给 值 对 象 赋值 时 ， 如 何 处 理 


mapping 


# 默认 allow nil: false 

customer composed of :address, allow nil: false 
# WA 

customer = Customer.new 

customer.address # 为 Address 4° Æ nil 


# 设置 allow nil: true 

customer composed of :address, allow nil: true 
# 则 有 

customer = Customer.new 

customer.address 4 为 NilClass I$ * 7 nil 


4 不 建议 使 用 constructor 和 converter， 而 是 用 "类 "来 代替 
# 因为 测试 、 维 护 都 不 方便 ， 特 别 是 有 一 定 复杂 度 的 时 候 
composed of :ip address, 

class name: 'IPAddr', 

mapping: %w(ip to i), 

constructor: Proc.new ( |ip| IPAddr.new(ip, Socket:: 
AF INET) }, 

converter: Proc.new ( |ip| ip.is a?(Integer) ? IPAdd 
r.new(ip, \n 

Socket::AF INET) : IPAddr 

.hew(ip.to s) } 


constructor # 第 一 次 调用 x.ip address 如 何 初 始 化 
converter # 调用 x.ip_address= N > w47 fa p R 


默认 关联 对 象 只 有 在 第 一 次 调用 ， 才 会 初始 化 注意 这 个 特点 ， 否 则 你 会 发 再 一 些 
奇怪 现象 。 例 如 : 


customer - Customer.new 


# 第 一 次 调用 ， 初 始 化 关联 对 象 
customer.address 
=> #<Address:0x007f8dabd87940 @street=nil, @city=nil> 


# 赋值 

customer.address street = "Hyancintvej" 
customer.address city = "Copenhagen" 
# 奇怪 现象 


# customer 的 address 关联 对 象 之 前 已 经 被 实例 化 了 ， 所 以 上 面 赋值 "不 起 作用 " o 


customer.address # => #<Address:0x007f8dabd87940 @street= 
nil, @city=nil> 


customer.save 
customer.reload 


# 保存 、 重 新 加 载 ， 发 现 上 面 赋值 "已 经 起 作用 "。 

customer.address 

=> #<Address:0x007fe99a433a60 @city="Copenhagen", @street="Hyanc 
intvej"> 


4 _ 


Builder - 功能 的 实现 
实际 指 的 是 Builder Associations， 关 联 方法 带 来 的 基本 方法 。 


主要 做 6 件 事 


|] block (—5*12 gx OWA » 


define_extensions model, name, &block 


create_reflection model, name, scope, options, extension 


Tu X HE Se se ce ae 
| FAR ZF) ONUS UK AO Ik 


define_accessors model, reflection 


SIE (J| ER. A HIE BR ZEN 
Ya) (I| PS E] AJ VR SE) 


define callbacks model, reflection 


define validations model, reflection 


| ] ] ) 六 
关系 图 
Hasone & BelongsTo HasMany 
| | 
V V 
SingularAssociation & CollectionAssociation 
| 
V 
Association 
HasAndBelongsToMany 


e 参数 相关 处 理 : 
o 参数 是 否 合法 
o 中 间 表 (join_table, class name, source 及 多 对 多 关系 的 自动 生成 … 等 ) 
o autosave 相关 实现 


Note: 对 关联 表 的 处 理 时 ， 大 量 使 用 了 reflection 里 面 的 实例 方法 。 


RAE: 
class << self 
attr_accessor :extensions 
attr_accessor :valid_options 
end 
build 
create_builder 
define_callbacks 
define_accessors 
define_readers 
define writers 


define validations 


valid dependent options 


实例 方法 : 
attr reader :name, :scope, :options 
build 
macro 
valid options 
validate options 


define extensions 


其 它 类 方法 : 


check dependent options 


add destroy callbacks 


2) Si lar A iati 
类 方法 : 


define accessors 
define constructors 
define validations 


实例 方法 : 


valid options 


3) Collect ^ iati 
类 方法 : 


define callbacks 
define callback 


define readers 
define writers 


实例 方法 : 
valid options 
attr reader :block extension 


define extensions 


wrap. scope 


4) -Has-One 
类 方法 : 


valid dependent options 
其 它 类 方法 : 

add destroy callbacks 
实例 方法 : 


macro 
valid options 


类 方法 : 
valid dependent options 


define callbacks 
define accessors 


实例 方法 : 


macro 
valid options 


其 它 类 方法 : 


add_counter_cache_methods 
add counter cache callbacks 


touch record 


add touch callbacks 
add destroy callbacks 


6)-Has-Many 
类 方法 : 


valid dependent options 
实例 方法 : 


macro 
valid options 


实例 方法 : 
attr reader :lhs model, :association name, 


through model 
middle reflection 


middle options 


belongs to options 


options 


Reflection - 实现 之 关联 两 者 
关系 图 


HasManyReflection & HasOneReflection & BelongsToReflection & Has 
AndBelongsToManyReflection RuntimeReflection 
| 


| 
V 


V 
AggregateReflection & AssociationReflection 
PolymorphicReflection 


V 
V 
MacroReflection & 
ThroughReflection 


| 
V 


AbstractReflection 


延续 build 目录 下 association 文件 的 工作 。 


一 个 很 重要 的 概念 ， 包 含 了 所 有 的 关联 信息 。 包括 但 不 限于 : 用 的 是 什么 关联 、 关 
联 对 象 名 字 、 可 选 参数 等 。 


一 般 关 联 和 aggregate 要 区 分 开 来 。 前 者 用 _reflections， 后 者 用 
aggregate reflections. 


提供 方法 : 


1) 模块 方法 


create 


add reflection 
add aggregate reflection 


create 
可 以 创建 Aggregate Reflection > Has Many Reflection ` Has One Reflection 和 
Belongs To Reflection 4 种 关联 ; 
如 果 使 用 了 through 则 还 会 自动 生成 Through Reflection 关联 。 


2) RAK 


reflections £ 所 有 正常 的 关联 
reflect on all associations macro &j reflections 


reflect on all autosave associations # 





> autosave: true 的 ref 


lections 
reflect on all aggregations # 所 有 aggregate 
以 下 两 方法 要 提供 被 关联 对 象 名 字 


reflect on association 
reflect on aggregation 


使 用 举例 


User.reflections.keys 
-» [:comments, 
:warehouse] 


User.reflections.each pair ( |a, x| puts [a, x.macro].join(' => ' 
) Hh 
-» comments  -» has many 

warehouse -» belongs to 


User.reflections.values.first.class 
=> ActiveRecord::Reflection::AssociationReflection 


r = User.reflections[:warehouse] 
=> #<ActiveRecord: :Reflection: :AssociationReflection: 0x007ffF4606 
c66d0 
@active_record= 
User(id: integer, login: string, email: string, warehouse_id: 
integer), 
@class_name="Warehouse", 
@collection=false, 
@klass= 
Warehouse(id: integer, name: string), 
@macro=:belongs_to, 
@name=:warehouse, 
@options={}, 
@plural_name="Warehouses", 
@quoted_table_name=""warehouses’", 
@table_name="Warehouses"> 


r.active_record 
=> User(id: integer, login: string, email: string, warehouse_id: 
integer) 


Post.reflections[:comments].table name # => "comments' 
Post.reflections[:comments].macro # => :has many 
Post.reflections[:comments].primary key name # 





Post.reflections[:comments].foreign key # => 








Reflection 虽然 很 重要 ， 但 对 于 普通 Web 开发 者 而 言 ， 使 用 场景 有 限 ， 一 般 不 会 直 
接 使 有 用。 下面 是 我 想到 的 一 些 使 用 场景 ， 供 参考 : 


1. 动态 创建 其 关联 对 象 的 实例 ， 如 : 在 表单 里 点 击 按钮 ， 创 建 一 个 甬 套 对 和 象 ( 属 
NC o 
.查看 使 用 gem 后 引进 了 什么 关联 。 


3. 删除 菜 个 重要 对 象 时 ， 删 除 所 有 和 与 之 关联 的 对 象 。 预 防 用 :dependent 或 手动 
删除 会 有 遗漏 。 


Abstract Reflection 


build association 


table name 

quoted table name 
primary key type 
class name 

join keys 


Macro Reflection 
继承 于 Abstract Reflection 


attr reader :name, :scope, :options, :active record, :plural nam 
e 


autosave- 
klass 
compute class 


^ iation Reflecti 


Association Reflection 2 Æ% Macro Reflection 又 继承 于 Abstract Reflection 


klass 
compute_class 


attr_reader :type, :foreign_type 
attr_accessor :parent_reflection 


association_scope_cache 
constructable? 


join_table 
foreign key 


association foreign key 
association primary key 


active record primary key 

counter cache column 

check validity! 

check validity of inverse! 

check preloadable! & check eager loadable! 


join id for 


through reflection 
source reflection 


chain 


Scope chain 

inverse of 

polymorphic inverse of 
macro 


association class 


nested? 

has inverse? 
collection? 
validate? 
belongs to? 
has one? 
polymorphic? 


举例 : 可 选 参数 inverse of 可 与 哪些 关联 或 不 可 与 哪些 可 选 参 数 一 起 使 用 。 


VALID AUTOMATIC INVERSE MACROS = [:has many, :has one, :belongs 
to] 

INVALID AUTOMATIC INVERSE OPTIONS - [:conditions, :through, :pol 
ymorphic, :foreign key] 


A * Has Many Reflection ^ Has One Reflection ` Belongs To Reflection 和 Has 
And Belongs To Many Reflection 都 继承 于 Association Reflection. 它们 这 几 个 方法 
比较 少 ， 就 不 再 一 一 列举 。 


继承 于 Macro Reflection 


mapping 


继承 于 Association Reflection 
macro 


collection? 


Has-Qne-Reflection 
继承 于 Association Reflection 
macro 


has one? 


继承 于 Association Reflection 
macro 
belongs. to? 


join keys 
join_ id_for 


继承 于 Association Reflection 
macro 


collection? 


继承 于 Abstract Reflection 


attr reader :delegate reflection 


delegate :foreign key, :foreign type, :association foreign key, 
:active record primary key, :type, :to => :source refle 
ction 


klass 

source reflection 
through reflection 
chain 

scope chain 

join keys 


nested? 

association primary key 
source reflection names 
source reflection name 
source options 

through options 
join id for 

check validity! 


Pol hie Reflect 


klass 
Scope 


table name 
plural name 


join keys 
type 
constraints 


source type info 


Runtime Reflecti 


klass 

table name 
constraints 
source type info 
alias candidate 
alias name 

all includes 


Association 5 - 实现 之 提供 方法 


关系 图 
HasOneThroughAssociation BelongsToPolymorphicAssociation HasMan 
yThroughAssociation 
| | | 
V V V 
HasOne & BelongsTo HasMany 
| | 
V V 
SingularAssociation & CollectionAssociation 
| 
V 
Association 
# 其 它 : 
ForeignAssociation 
ThroughAssociation 


关联 方法 带 来 的 高 级 的 方法 ， 对 外 提供 接口 。 


概念 : a.b 或 a.bs 组 成 一 个 Association， 把 它们 看 成 是 一 个 整体 。 但 前 者 为 
owner， 后 者 为 target. 


实现 对 关联 对 象 的 操作 。 


^ iati 


attr reader :owner, :target, :reflection 
attr accessor :inversed 


delegate :options, :to -» :reflection 


aliased table name 
reset 

reload 

loaded? 

loaded! 

stale target? 
target- 

scope 

association scope 
reset scope 

set inverse instance 
klass 

target scope 

load target 


interpolate 


marshal dump 
marshal load 


initialize attributes 


调用 到 了 AssociationScope ` AssociationRelation 等 类 。 


handle dependency 


replace 
reset 


updated? 


decrement counters 
increment counters 


klass 


Collection A iati 


reader 
writer 


ids reader 
ids writer 


reset 
select 


find 


first 
second 
third 
fourth 
fifth 
forty two 
last 


build 
create 
create! 
concat 


transaction 


delete all 
destroy all 


count 


delete 
destroy 


size 
length 


empty? 
any? 
many? 


distinct 
uniq 


replace 
include? 

load target 
add to target 


replace on target 


scope 
null scope? 


CUERO 


foreign key present? 


handle dependency 


insert record 


empty? 


Has Many Ti hA iati 


size 
concat 


concat records 
insert record 


Has ene A iati 


handle dependency 


replace 
delete 


Has One TI hA iati 


# 直接 替换 关联 对 象 的 话 ， 如 果 创建 、 删 除 


replace 


# 有 关联 对 象 及 设置 :dependent 时 ，3 种 删除 方式 
delete 


# 处 理 依赖 


handle dependency 


T lat 


reader 
writer 


create 
create! 


build 


7i hA iat 


delegate :source reflection, :through reflection, :to -» :reflec 
tion 


4 个 关联 方法 的 使 用 
对 外 提供 接口 。 


Rails 提供 了 4 个 类 方法 ， 用 于 声明 对 象 与 对 象 之 间 的 关系 。 它 们 的 意思 ， 理 解 起 
来 很 简单 ， 和 字面 意思 一 样 ， 如 "Project has one Project Manager" 或 "Project 
belongs to a Portfolio". 但 实际 使 用 过 程 ， 还 是 有 很 多 要 注意 的 。 不 同 的 场景 ， 需 
不 同 的 参数 ; 并 且 ， 它 们 会 引入 一 些 额 外 的 方法 ， 有 的 和 attr * 类 似 ， 但 有 的 不 
是 < 


class Project < ActiveRecord::Base 


belongs to : portfolio 
has one :project manager 
has many :milestones 


has and belongs to many :categories 
end 


上 面 例 子 里 的 场景 最 简单 ， 不 需要 带 任 何 参数 ; 下 面 是 它们 引入 的 额外 的 方法 ， 包 
括 但 不 限于 : 


# 1 

Project#portfolio 
Project#portfolio=(portfolio) 
Project#portfolio.nil? 


# 2 

Project#project_manager 

ProjectZproject manager-(project manager) 
Project#project_manager.nil?, 


# 3 

Project#milestones.empty? 
Project#milestones.size 
Project#milestones 
Project#milestones<<(milestone) 
Project#milestones.delete(milestone) 
Project#milestones.destroy(milestone) 
Project#milestones.find(milestone_id) 
Project#milestones.build 
Project#milestones.create 


# 4 

Project#categories.empty? 
Project#categories.size 
Project#categories 
Project#categories<<(category1) 
Project#categories.delete(category1) 
Project#categories.destroy(category1) 


注意 : 可 选 参 数 :dependent 在 has one 和 belongs to 里 ， 删 除 关联 用 的 是 
delete ; 而 在 has many 里 ， 删 除 关联 用 的 是 delete all. 这 两 者 要 做 的 事 性 质 上 是 
一 样 的 ， 但 请 注意 这 点 区 别 ， 并 且 它 们 都 没有 destroy all. 


上 述 对 方法 或 参数 的 解释 ， 仅 供 和 参考， 实际 情况 以 运行 结果 为 准 。 


当 不 确定 参数 表示 什么 意思 ， 使 用 后 有 什么 效果 时 ， 请 懂 用 ， 可 以 选择 其 它 确定 /有 
把 握 的 方法 代替 。 


4 个 关联 方法 的 使 用 
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belongs to 


方法 本 身 表 示 什 么 意思 


指定 一 对 一 关系 。 如 果 ，" 自 己 belongs_to 关联 对 象 "， 那么 自己 需要 包括 "关联 对 
象 的 外 键 "。 


引进 了 哪些 方法 ， 表 示 什 么 意思 。 


后 面 几 个 方法 ， 作 用 类 似 ， 只 是 细节 部 分 有 所 不 同 ， 使 用 时 注意 一 下 即 可 。 


有 什么 参数 ， 表 示 什 么 意思 ， 使 用 后 有 什么 效 


AW 


普通 参数 Scope 


ü 
设置 一 个 scope， 通 过 前 者 查询 后 者 的 时 候 ( 其 它 时 候 不 影响 )， 自 动 加 到 查询 语句 
。 (类 似 在 后 者 model 里 定义 了 一 个 default scope， 但 只 有 通过 前 者 查询 才 起 作 


belongs to :user, -> { where(id: 2) ) 
# 同时 join XA X5; friends 
belongs to :user, -» ( joins(:friends) ) 
关联 对 月 的 game level 必须 大 于 level.current 
belongs to :level, ->(level) { where("game level > ?", level.cur 
rent) ) 


使 用 primary. key 前 后 对 比 : 


belongs to 


author belongs to :book 

author.book 

# => SELECT `books`.* FROM "books WHERE ‘books . id = author.i 
dar MEI 

author belongs_to :book, primary_key: :alias_book_id 

author.book 


# => SELECT 'books'.* FROM ‘books WHERE "books. alias book id' 
= éllvjclaoir nae! (Lagi di 
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has one 


方法 本 身 表 示 什 么 意思 。 


HE 一 对 一 关系 。 如 果 ，" 前 者 has_one 后 者 "， 那 么 ' 后 者 ' 需 要 包括 ' 前 者 id' 属 性 。 


引进 了 哪些 方法 ， 表 示 什 么 意思 。 


这 里 的 解释 参考 了 belongs to ， 不 单 它们 的 方法 名 是 一 样 的 。 定 们 定义 方法 就 
也 是 一 样 的 。 


3 * belongs to 和 has one 都 属于 Singular Association. 


有 什么 参数 ， 表 示 什 么 意思 ， 使 用 后 有 什么 效果 。 
普通 参数 Scope 
置 


一 个 scope， 通 过 前 者 查询 后 者 的 时 候 (其 它 时 候 不 影响 )， 自 动 加 到 查询 语句 
o Monica model 里 定义 了 一 个 default _ scope， 但 只 有 通过 前 者 查询 才 起 作 


Pa 


zT» 


里 
用 ) 
举例 |; 


has_one :author, -> { where(comment_id: 1) } 

has_one :employer, -> { joins(:company) } 

has_one :dob, ->(dob) { where("Date.new(2000, 01, 01) > ?", dob) 
} 


其 它 


使 用 primary key 前 后 对 比 : 


has one 


book has one :author 


book.author 

4 传递 的 值 是 book ,id 

4 => Author Load (6.5ms) SELECT authors .* FROM authors Mn 
WHERE ‘authors’. book id' = book.id LIM 

IT 1 


book has_one :author, primary_key: :a_primary_id 


book. author 

# 传递 的 值 是 book.a primary id 

4 => Author Load (6.5ms) SELECT ‘authors .* FROM 'authors' Mn 
WHERE ‘authors’. book id = book.a prim 

ary id LIMIT 1 


has many 


方法 本 身 表 示 什 么 意思 。 


指定 一 对 多 关系 。 


引进 了 哪些 方法 ， 表 示 什 么 意思 。 


以 上 解释 ， 参 考 了 官方 文档 。 但 因为 各 个 参数 组 合 起 来 ， 呈 几何 倍数 的 增长 ， 验 证 
过 程 难免 有 朴 漏 ， 实 际 情 况 以 运行 结果 为 准 。 


有 什么 参数 ， 表 示 什 么 意思 ， 使 用 后 有 什么 效果 。 


普通 参数 Scope 
设置 一 个 scope， 通 过 前 者 查询 后 者 的 时 候 (其 它 时 候 不 影响 )， 自 动 加 到 查询 语句 
里 。( 类 似 在 后 者 model 里 定义 了 一 个 default _ scope， 但 只 有 通过 前 者 查询 才 起 作 
用 ) 
举例 : 

# scope 里 面 的 查询 对 象 默 认 是 被 关联 对 象 


has many :comments, -> ( where(author id: 1) } 
has many :employees, -» ( joins(:address) ) 


es ay 3 P. Fé waa) oO = 
O €Y m 0I Bal ST R 用 到 | A e 
scope -—unDmJe€ 1^ A/N A H 
J v * 4 M Y 


has many :posts, ->(post) ( where("max post length > ?", post.le 
ngth) } 


2 


普通 参数 Extension 


前 面 提 到 过 ， 使 用 这 几 个 关联 方法 时 ，" 它 们 会 引入 一 些 额 外 的 方法 "， 并 且 上 文 已 
经 介绍 了 它们 。 但 如 果 我 们 想 要 引入 自己 的 方法 ， 并 且 用 途 基 本 一 样 ， 要 怎么 做 ， 
可 以 用 Extension. 


举例 : 


class Organization « ActiveRecord::Base 
has many :people do 
def find active 
find(:all, :conditions => ["active = ?", true]) 
end 
end 
end 


现在 ， 可 以 用 organization.people.find active 对 后 者 进行 操作 。 这 样 定义 
的 方法 ， 和 CollectionProxy 定义 的 方法 类 似 。 


Note: 这 些 Extension 方法 ， 类 似 在 后 者 model 里 定义 的 scope, 但 只 能 通过 前 
者 .后 者 这 种 方法 调用 | 


has and belongs to many 


方法 本 身 表 示 什 么 意思 
指定 多 对 多 关系 。 用 中 间 表 来 连接 前 者 与 后 者 。 如 果 没 有 明确 的 指定 中 间 表 的 名 


后 
证 ， 那 么 默认 按 前 者 、 后 者 的 字母 顺序 i 间 表 。 


Hi. 


引进 了 哪些 方法 ， 表 示 什 么 意思 。 


有 什么 参数 ， 表 示 什么 意思 ， 使 用 后 有 什么 效果 。 
普通 参数 Scope 
X E 


一 个 scope， 通 过 前 者 查询 后 者 的 时 候 (其 它 时 候 不 影响 )， 自 动 加 到 查询 语句 
o (类 似 在 后 者 model 里 定义 了 一 个 default_scope， 但 只 有 通过 前 者 查询 才 起 作 


has and belongs to many :projects, -> { includes :milestones, :m 

anager ) 

has and belongs to many :categories, ->(category) { 
where("default category - ?", category.name) 


j 


4 Extension 


普通 参 
前 面 提 到 过 ， 使 用 这 几 个 关联 方法 时 ，" 它 们 会 引入 一 些 额外 的 方法 "， 并 且 上 文 已 
经 介绍 了 它们 。 但 如 果 我 们 想 要 引入 自己 的 方法 ， 并 且 用 途 基 本 一 样 ， 要 怎么 做 ， 
可 以 用 Extension. 


举例 : 


has and belongs to many :contractors do 
def find or create by name(name) 
first name, last name - name.split(" ", 2) 
find or create by(first name: first name, last name: last na 
me) 
end 
end 


现在 ， 可 以 用 organization.people.find active 对 后 者 进行 操作 。 这 样 定义 
的 方法 ， 和 CollectionProxy 定义 的 方法 类 似 。 


Note: 这 些 Extension 方法 ， 类 似 在 后 者 model 里 定义 的 scope, 但 只 能 通过 前 
者 .后 者 这 种 方法 调用 | 


关联 方法 的 可 选 参数 汇总 
belongs to 
valid_options 


ActiveRecord::Associations::Builder::BelongsTo.valid options nil 


valid dependent options 


ActiveRecord::Associations::Builder::BelongsTo.valid dependent o 
ptions 


has one 


valid options 


ActiveRecord::Associations::Builder::HasOne.valid options throug 
h: 'fakers' 


valid dependent options 


ActiveRecord::Associations::Builder::HasOne.valid dependent opti 
ons 


has many 


valid options 


ActiveRecord::Associations::Builder::HasMany.valid options nil 


valid dependent options 


ActiveRecord::Associations::Builder::HasMany.valid dependent opt 
ions 


has and belongs to many 


fe has many 一 样 。 


实现 关联 对 象 : 


小 


参数 belongs to has one 
:class name y 
foreign key Y 
foreign type y 
:primary_key V 
:as 

:through 


:SOUTCe 


| 


:source type 
join table 
:association foreign key 
:table name 
:autosave 
:dependent 
:before add 
:after add 
:before remove 
:after remove 

: validate 
‘required 
:counter cache 
:polymorphic 
:touch 
inverse of 


:anonymous class 


过 Me s B = m < n 


:optional 
:extend 


index errors 


详解 : 


has_many 


Ni 


ae << eg ee ee 


| x e x aee << ee 一 


habtm 
A 


m. < ea ee) 一 


class name 


指定 关联 对 象 所 对 应 的 "类 /Mode1"， 默 认 是 "驼峰 "转换 关联 对 象 的 名 字 。 
不 符合 约定 时 ， 用 :class name 指明 。 


:class name 不 影响 :foreign key "关联 对 象 id" 属性 的 命名 约定 。 
foreign key 
belongs to - 默认 是 "关联 对 象 _ id"， 外 键 存在 在 自己 表 里 。 
has many 等 - 声明 自己 在 关联 对 象 里 的 外 键 。 
primary_key 
查询 关联 对 象 的 时 候 ， 用 自己 的 哪个 字段 做 为 条 件 。 
指定 关联 对 象 的 "主键 "0， 保 存在 关联 对 象 的 表 里 ， 查 询 关 联 对 象 时 用 到 。 查 询 关 联 对 象 


时 ， 自 己 保 存 的 外 键 对 应 着 关联 对 象 的 主键 (默认 是 id)， 如 果 不 符合 约定 ， 可 以 用 
primary key 指明 。 


凡是 通过 前 者 查询 后 者 。 传 递 的 是 前 者 的 主键 所 对 应 的 值 ， 也 就 是 id 字段 的 值 ， 如 果 
觉得 不 合适 ， 可 以 用 :primary key 指明 字段 。 


as 
多 态 时 用 到 ， 声 明 多 态 的 接口 。 和 belongs to 里 的 :polymorphic 配对 使 用 。 


through 


在 中 间 表 里 ， 项 望 关联 对 象 怎 么 被 表示 。( 听 起 来 是 不 是 有 点 绕 ， 管 得 也 太 多 了 吧 ) 
指定 中 间 表 。 优 先 级 比 :class_name » :primary_key 和 :foreign key 要 高 。 
实现 关联 时 用 到 了 reflection 的 代码 ， 所 以 has one X belongs to 关联 要 
使 用 中 间 表 ， 只 能 通过 :through 这 一 种 方式 ， 区 别 于 has many :through 和 h 
as and belongs to many. 


指定 中 间 表 。 优 先 级 比 :class_name, :primary key 和 :foreign key 要 高 。 
«br» 如 果 对 应 的 关联 是 belongs to 则 ， 关 联 表 会 被 自动 更 新 、 创 建 、 删 除 。 否 则 
， 关联 表 为 只 读 状 态 ， 也 就 是 说 创建 后 你 就 只 能 手动 维护 ， 不 会 自动 更 新 、 删 除 。 <br 
> 如 果 你 要 更 改 关联 ， 最 好 配置 一 下 :inverse of 选项 ， 以 便 被 关联 对 象 及 时 更 新 
与 其 父亲 的 关系 。 


source 
必须 和 :through 配合 使 用 ， 自 己 在 中 间 表 里 用 什么 表示 。 (类似 sas) 
配合 :through 使 用 ， 当 查询 关联 表 数 据 时 用 哪 张 表 的 字段 。 例 如 has many :sub 
scribers, through: :subscriptions， 如 果 不 指 定 ， 默 认 会 查询 :subscribe 
rs X :subscriber X 
M A 并 且 " 前 者 ,后 者 "可 拆 分 成 1)" 前 者 ， ae ，2)" 中 间 表 ， 


J 步 一 般 不 会 有 误 ， 但 如 果 后 者 名 字 不 规范 ， 那 么 在 第 步 " 中 间 表 ,后 者 
"就 会 ipod 用 :source 明确 后 者 对 应 中 间 表 里 的 什么 关联 。 


source type 


必须 和 polymorphic 配合 使 用 。 多 态 时 希望 自己 用 什么 做 为 类 型 。 
影响 的 是 数据 ， 不 是 属性 


a 度 来 看 ， 后 者 与 前 者 的 关联 应 该 是 belongs_to. 但 如 果 恰 好 又 是 多 态 ， 


么 后 者 保存 有 前 者 的 id 并 指定 某 个 类 型 ， 如 果 你 对 按 约 定 生成 的 类 型 不 满意 ， 可 以 
1 :source type 指明 。 


foreign_type 


1 对 于 has one 和 has_many， 用 什么 字段 做 为 自己 的 外 键 。<br> 
2 对 于 belongs_to， 用 什么 字段 做 为 关联 对 象 的 外 键 ， 字 段 保 存在 前 者 。 


指定 用 什么 "字段 "保存 关联 对 象 的 "多 态 信息 "， 保 存在 自己 的 表 里 ， 多 态 时 用 到 。 默 认 
用 "关联 对 象 _type" 这 个 字段 ， 不 符合 约定 时 ， 用 :foreign_type 指明 。 


没有 这 个 选项 之 前 ， 这 个 字段 只 能 根据 `:as ”生成 ， 不 能 自 定义 。 


自己 不 符合 约定 。 多 态 时 ， 在 关联 对 象 的 表 里 ， 用 什么 字段 来 存储 父亲 对 象 的 类 型 (默认 
是 x_type ;根据 :as mR) 


多 态 时 ， 在 关联 对 象 的 表 里 ， 用 什么 字段 来 存储 父亲 对 象 的 类 型 (默认 是 x type JR 
据 :as mR) 


optional 


belongs to 默认 会 检测 其 关联 的 对 象 是 否 存 在 ， 如 果 不 存在 则 不 能 保存 自己 。 设 置 为 
false 后 ， 则 没有 上 述 特性 。 


extend 


作用 和 extension 类 似 。 


join table 


TRA 


指定 中 间 表 的 名 字 ** 注 意 :** 如 果 你 给 中 间 表 加 了 对 应 的 ' 类 '， 并 且 命 名 不 符合 约定 
的 话 。 那 么 一 定 要 记得 在 每 个 has and belongs to many 的 地 方 都 要 设置 join_ 
table 


- 注意 前 者 与 后 者 的 顺序 比较 方法 ， 如 果 前 几 个 字符 一 样 ， 则 往 后 一 个 个 字符 比较 ， 如 
"paper boxes" 和 "papers" 生成 的 中 间 表 名 字 是 "paper boxes papers" 

而 不 是 "papers_paper_boxes". 

- 如 果 前 者 和 后 者 使 用 的 表 名 都 带 有 前 级 并 且 还 相同 ， 那 么 中 间 表 的 名 字 也 用 同样 的 前 

级， 剩余 部 分 用 再 按 字母 顺序 排序 。 如 : "catalog categories" 和 "catalog p 

roducts" 生成 的 中 间 表 是 "catalog categories products". 


association foreign key 


在 中 间 表 里 ， 和 希望 关联 对 象 用 什么 字段 做 为 外 键 。( 听 起 来 是 不 是 有 点 绕 ， 管 得 也 太 多 了 
吧 ) 


指定 后 者 所 对 应 的 外 键 ， 如 Person has and belongs to many :projects, 
则 中 间 表 里 后 者 所 对 应 的 外 键 是 “project_id”。 如 果 不 符 合 要 求 ， 你 使 用 使 用 :as 
sociation foreign key 设置 


作用 : 相当 于 has and belongs to many 时 belongs to 部 分 的 foreign k 
ey 


autosave 


保存 自己 时 ， 自 动 保存 关联 对 象 。 
如 果 在 model 里 使 用 了 accepts nested attributes_for， 则 对 应 :autosav 
e 始终 为 true. 


设置 为 true， 保 存 自己 的 时 候 ， 同 时 保存 它 的 关联 对 象 ( 用 的 是 before_save)。 设 
置 为 false 还 可 分 为 两 种 情况 : 前 者 为 new_record， 则 保存 自己 时 会 自动 保存 关 
联 对 象 ; 否则 上 述 自动 操作 都 不 会 被 执行 。 

设置 为 true， 保 存 父 亲 对 象 时 ， 其 关联 对 象 同 时 被 保存 。 设 置 为 false， 对 关联 对 
象 不 做 任何 操作 。 黑 认 ， 只 有 被 关联 对 象 为 new record 时 才 会 自动 保存 。<br> 使 


用 accepts nested attributes for 会 自动 设置 :autosave 为 true. 


以 before save 的 形式 来 调用 ， 所 以 会 受到 其 它 before save 回调 方法 的 影响 。 


dependent 


1 belongs to A destroy 和 delete<br> 

2 has many 有 destroy ^` delete all^nullify "restrict with excepti 
on 和 restrict with error«br» 

3 has one 有 destroy^ delete ` nullify ^ restrict with exception 和 
restrict with error 


- ^idestroy^ MR (destroy) MARAKA o 


- ^Àidelete all' 和 destroy 类 似 ， 也 是 删除 所 有 被 关联 对 象 。 但 区 别 在 于 ， 
此 删除 操作 不 会 触发 回调 。 


- “ :nullify ”设置 后 者 的 "前 者 _id" 属 性 为 nil. 不 会 触发 回调 。 


- ^irestrict with _ exception” 有 关联 对 象 则 抛 异 常 。 并 且 后 面 与 之 的 无 关 代 
码 也 不 能 再 运行 。 


- “:restrict with error” 有 关联 对 象 则 设置 对 象 的 errors 信息 。 并 且 后 
面 与 之 无 关 的 代码 还 能 运行 。 


如 果 设 置 为 :destroy， 自 己 被 destroy 时 ， 关 联 对 象 会 被 destroy. 如果 设置 
为 :delete， 自 己 被 destroy 时 ， 关 联 对 象 会 被 delete. 注意 :自己 被 delet 
e, 始终 不 影响 关联 对 象 。 


| 除 前 者 时 ， 对 后 者 进行 什么 操作 。1) :destroy， 删 除 后 者 ， 会 触发 回调 ;2) :de 
qua 删除 后 者 ， 不 会 触发 回调 ;3) : :nullify， 把 后 者 里 的 "前 者 _id" 属 性 设置 
为 nil， 不 会 触发 回调 ; 4) :restrict_with_exception， 如 果 有 后 者 的 关联 对 
象 ， 报 异常 ;5) :restrict with error 如 果 有 后 者 的 关联 对 象 ， 报 错 


可 选 :destroy， 也 就 是 使 用 destroy 删除 所 有 关联 对 象 ; 可 选 :delete_al1， 
也 就 是 使 用 delete 删除 所 有 关联 对 象 ; 可 选 :nullify， 把 外 键 设 为 nil， 但 不 删 
除 对 象 ; 可 选 :restrict_with_exception， 有 关联 对 象 则 抛 异 常 ; TH :restr 
ict with error: AKRAM FM WR 


当 关 联 对 象 与 自己 的 关系 是 has many 4° HEA ^:dependent^. 因为 关联 对 象 
被 同时 删除 的 话 ， 意 味 着 自己 的 兄弟 将 成 为 缴 儿 (没有 关联 对 象 可 关联 )。 


validate 


保存 自己 的 时 候 ， 校 验 内 存 里 的 关联 对 象 (不 是 相应 字段 ) 是 否 存在 于 数据 库 里 。 


1 设置 7 validate<br> 

2 不 设置 Validate， 但 设置 了 autosave, 或 has many 和 habtm XX » «br 
> 

3 


方法 名 是 : autosave_association 里 的 :"validate associated record 
s_for #{XR1%}"<br> 
4 内 容 是 :validate collection association 或 :validate single ass 
ociation<br> 
5 后 面 使 用 validate 进行 执行 <br> 
6 校 验 关 联 是 否 成 立 ， 并 且 关 联 对 象 是 否 存 在 。 


类 似 validate presence of :关联 对 象 


设置 为 true， 保 存 自己 的 时 候 ， 会 先 校 验 它 的 关联 对 象 。 默 认 是 false， 也 就 是 不 


对 于 是 否 是 new record 在 做 valid? 时 ， 会 造成 迷惑 。 牢 记 ， :validate’ & 
味 着 对 前 者 和 后 者 都 有 "保存 "操作 。 如 果 校 验 失 败 ， 则 本 次 保存 失败 。 


校 验 关 联 对 和 象 是 否 丨 实 存 在 于 数据 库 里 。 设 置 为 false， 保 存 前 者 时 不 会 校 验 后 者 。 
默认 就 是 false. 


inverse of 
通过 自己 查找 到 关联 对 象 ， 然 后 又 通过 关联 对 象 找 回 自己 。 


有 的 关联 会 自动 推断 inverse_of， 所 以 用 不 用 其 实效 果 一 样 。 而 有 的 关联 加 上 参数 后 
， 不 起 作用 ， 所 以 即使 设置 也 没 用 。 可 以 根据 以 下 代码 进行 检测 : 


ModelName.reflections.map do |key, value| 


p "Z(key) inverse of: #{value.has_inverse?}" 
end 


counter cache 


分 为 几 种 情况 : 
1 belongs to 里 设置 为 true 表明 使 用 counter. (字段 使 用 默认 )<br> 


2 belongs to 里 设置 counter 字段 。<br> 
3 has many ”里 设置 counter 字段 。 


设置 为 true 5  HTRMERME Ankk EIREJA" o RUE fal 
se， 也 就 是 不 起 作用 。 


计数 器 是 根据 "前 者 对 应 的 table name + count" 生 成 的 ， 如 里 不 符合 "约定 "， 可 
以 用 :counter cache 指明 。 自 定义 计数 器 名 字 的 时 候 ， 建 议 把 此 属性 声明 为 attr 


 readonly. #E»° :counter cache 可 以 设置 为 true、false、 或 自 定 义 的 名 字 


o 


定制 用 什么 字段 保存 关联 表 的 统计 数目 


touch 


1 设置 为 true， 更 新 自己 后 ， 更 新 关联 对 象 的 updated at/on 字段 。<br> 
2 设置 为 其 它 字 段 ， 则 更 新 自己 后 ， 额 外 更 新 关联 对 象 的 updated at/on 和 其 它 字 


Ro 


设置 为 true, RFR destroy 自己 的 时 候 ， 关 联 对 象 的 updated at/on 属性 会 
被 更 新 。 


如 果 你 不 是 设置 成 true, 而 是 传递 一 个 符号 :symbol， 那 么 这 个 符号 会 被 更 新 为 当 
前 时 间 。 


required 


要 求 有 关联 对 象 存 在 于 数据 库 。 


语法 糖 。 原 来 的 做 法 是 "belongs to 关联 对 象 "n + "validates presence of 
关联 对 象 "， 现 改 为 "belongs to RHR, required: true" 


"validates presence of 关联 对 象 " 和 "validates presence of XX 
id" 大 同 小 异 。 前 者 是 丨 实 存 在 的 对 象 ， 后 者 只 是 字段 。 


readonly 
所 有 关联 对 象 为 只 读 。 


设置 为 true， 通 过 前 者 查询 到 的 后 者 限制 为 只 读 状 态 ， 不 可 更 改 。 但 其 它 方式 查询 出 
来 的 ， 不 受 此 限制 。 


polymorphic 
声明 此 关联 是 多 态 的 


如 果 你 同时 使 用 了 ` :counter_cache `， 建 议 在 后 者 的 model 里 把 计数 器 设置 为 a 
ttr readonly. 


inverse of 
保证 object id 相同 。 通 过 前 者 (1) 查 询 到 后 者 ， 然 后 再 通过 后 者 返 过 来 查询 前 者 (2 
)。 按 照 直 观 的 理解 ，(1) 和 (2) 应 该 是 同样 的 对 象 ， 同 样 的 值 。 但 实际 情况 会 发 现 
> 它们 不 一 样 (可 以 通过 object id 确定 ) ! 原因 是 程序 没有 这 么 聪明 ， 没 法 判断 它 
们 是 一 样 的 (特别 是 通过 中 间 表 查询 时 )。 设 置 :inverse_of， 可 解决 这 个 问题 。 
带 来 额外 的 好 处 : 1， 不 用 重复 查询 ， 节 省 了 性 能 ; 2. 因为 对 象 的 object_id 都 是 
一 样 的 ， 保 证 了 数据 一 致 性 ; 3， 注意 顺序 前 者 查询 后 者 ， 然 后 后 者 反 向 查询 前 者 ; 需 
要 注意 : 第 2 次 "查询 "不 是 数据 库 查询 ， 会 存在 操作 脏 数 据 的 风险 。 
通常 情况 下 ， 不 用 设置 ， 会 自动 转换 。 但 使 用 了 以 下 参数 ， 则 不 会 自动 转换 : :throug 
h、:as、:polymorphic 和 :conditions : 遇 到 单 复 数 不 规 则 ， 有 时 候 也 不 会 自动 
转换 


index_errors 


默认 为 false. 设置 了 autosave 它 才 管用 。 条 件 很 复杂 ， 忽 略 。 


anonymous class 


Reflection 那 边 用 到 ， 忽 略 。 


before add ` after add ^ before remove 和 after remove 


作用 于 集合 ， 和 普通 的 回调 差不多 ， 只 是 定义 的 位 置 不 同 而 疾 。 


心得 
关系 比较 复杂 的 时 候 ， 不 好 写 。 我 建议 先 从 简单 、 可 确定 的 入 手 ， 然 后 进行 下 一 
Wy o 


例如 : 自 关联 ， 或 者 通过 关联 表 实 现 关 联 ， 通 常 : 
e REA xxx_id 等 外 键 的 ， 通 常 就 是 belongs_to 
e 然后 对 应 其 关联 的 就 是 has many 


e 再 之 后 就 是 through 


4 个 关联 方法 的 补充 


只 有 :has many, :has one, :belongs to 才 有 可 能 自动 计算 inverse， 也 就 是 说 
has_and_belongs to_many 不 可 以 。 


若 上 述 声 明 里 包含 conditions, :through, :polymorphic, :foreign_key 则 同样 不 可 以 
自动 计算 inverse. 


所 有 参数 ， 目 标 总 结 起 来 就 这 几 个 


# 调用 时 传递 的 block 
define extensions model, name, &block 
关联 两 者 


create reflection model, name, scope, options, extension 


define accessors model, reflection 
H 和 关联 有 关 的 回调 (删除 、 自 动 保 存 等 ) 
define callbacks model, reflection 


T 04 UA 
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define validations model, reflection 


使 用 关联 方法 后 ，Rails 自动 生成 了 哪些 方法 


一 对 一 关系 ， 和 关联 有 关 的 读 写 访问 器 


生成 的 方法 belongs to i belongs to has_one 
:polymorphic 
association(force_reload = N N X 
false) 
association-(associate) V y V 
build association(attributes- N \ 
{}) 
create_association(attributes= Y \ 
{}) 
create_association! N \ 
(attributes={}) 
这 些 方法 主要 由 Association 和 Singular Association 提供 。 
一 对 多 、 多 对 多 关系 ， 和 关联 有 关 的 读 写 访问 器 
生成 的 方法 habtm has_many has many 
:through 

collection(force_reload = \ \ \ 
false) 
collection=objects y y V 
collection singular. ids y V y 
collection_singular_ids=ids Y y V 


这 些 方法 主要 由 Association 和 Collection Association 4 £t » 


一 对 多 、 多 对 多 关系 ， 对 关联 对 象 (特别 是 对 象 集合 ) 的 增删 查 改 


has many 


生成 的 方法 habtm — has many ahrcugh 
collection««(object, ...) y y NI 
collection.delete(object, ...) y y NI 
collection.destroy(object, ...) y y NI 
collection.clear y y q 
collection.empty? y y NI 
collection.size y y NI 
collection.find(...) y y NI 
collection.exists?(...) y y af 
an -0. \ J J 
collection.create(attributes = {}) V y y 
collection.create!(attributes = \ J J 


{}) 


Lit Zr AR Collection Proxy 提供 的 。( 除 上 述 方法 外 ， 还 有 的 未 列 出 ) 


has and belongs to many vs has many through 


has and belongs to many 意味 着 中 间 表 没有 model. 因此 ， 不 能 通过 id 进行 查 
询 ， 也 没有 validate、callback， 更 加 不 能 直接 读 取 & 设 置 其 值 。 唯 一 的 方便 之 处 
是 :通过 << 即 可 创建 中 间 表 数据 。 


当 你 需要 model ` id ` validate ` callback 或 对 中 间 表 数据 进行 操作 时 ， 建 议 改 为 使 
用 has many :throght， 这 时 可 以 通过 model 管理 中 间 表 数据 ， 不 必 也 不 能 再 << 


AKA 

Structure 
Primary Key 
Rich Association 
Proxy Collection 
Distinct Selection 
Self-Referential 
Eager Loading 
Polymorphism 


N-way Joins 


has and belongs to many 
habtm 
Join Table 
no 
no 
yes 
yes 
yes 
yes 
no 


no 


has many :through 
through association 
Join Model 

yes 

yes 

no 

yes 

yes 

yes 

yes 


yes 


x 
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7. 65 


TODO 


负责 处 理 自动 保存 相关 一 切 任务 。 


在 Builder::Association 里 有 构建 : 


def self.define callbacks(model, reflection) 
if dependent - reflection.options[:dependent] 
check dependent options(dependent) 
add destroy callbacks(model, reflection) 
end 


Association.extensions.each do |extension| 
extension.build model, reflection 


end 
end 


而 AssociationBuilderExtension 3E Æ 
Associations::Builder::Association.extensions 其 中 之 一 。 


对 应 着 的 私有 类 方法 : 


Ju autosave 


add autosave association callbacks 


就 是 上 面 这 方法 添加 的 回调 ， 非 常 重要 。 


常用 实例 方法 : 
mark for destruction 


marked for destruction? 


除 此 之 外 ， 还 有 实例 方法 : 


changed for autosave? 


destroyed by association 
destroyed by association- 


reload 


私有 类 方法 : 


define non cyclic method 


Alias Tracker 
作用 : 为 Join Dependency 和 Association Scope 服务 。 


实现 对 不 规则 表 名 的 跟踪 及 相关 处 理 。 


实例 方法 : 


attr reader :aliases, :connection 


aliased table for 
类 方法 : 

empty 

Create 


initial count for 


lation S 


场景 "关联 的 时 候 ， 关 联 表 带 有 scope"， 不 使 用 它 的 话 ， 生 成 的 SQL 里 能 看 到 有 的 
条 件 是 重复 的 。Association Scope 解决 了 这 个 问题 。 


另 ， 看 示例 还 有 另外 的 好 处 : 


class Review < ActiveRecord::Base 
belongs to :restaurant 


scope :positive, -> ( where("rating > 3.0") } 
end 


class Restaurant < ActiveRecord: :Base 

has_many :reviews 

has_many :postitive_reviews, -> { positive }, class_name: "Rev 
iew" 
end 


restaurants = Restaurant.includes(:positive_reviews).first(5) 


Collection Association ` Singular Associations 和 Association 调用 了 它 。 


作用 :为 Finder Methods 和 Query Methods 服务 。 
实现 joins 
class Physician < ActiveRecord::Base 
has many :appointments 


has many :patients, through: :appointments 
end 


以 下 两 种 查询 : 


Qphysician.patients.to a 


Physician.joins(:appointments).to a 


对 应 的 joins 3&6] XR E]8j > REASEIRA > Sh LIE Join Dependency 


Preloader 


使 用 includes, preload, eager. load 进行 预 加 载 时 ， 根 据 查询 条 件 不 同 ， 优 先 选择 
对 性 能 友好 的 方式 。 


class Author < ActiveRecord::Base 
4 columns: name, age 
has many :books 

end 


class Book « ActiveRecord::Base 


# columns: title, sales, author id 
end 


针对 上 述 关 联 ， 执 行 以 下 两 种 查询 : 


Author.includes(:books).where(name: ['bell hooks', 'Homer']).to 
a 


Author.includes(:books).where(books: (title: 'Illiad')).to a 


它们 对 应 的 SQL 差别 很 大 ， 性 能 差距 也 大 。 究 竞 要 执行 哪 种 查询 ， 可 以 让 
Preloader 来 判断 。 


A iation Relati 


针对 Scope merge 操作 的 实现 : 


# 可 以 被 重 写 (ThroughAssociation 里 就 这 么 做 ) 
def target scope 
AssociationRelation.create(klass, klass.arel table, klass.pred 
icate builder, self).merge!(klass.all) 
end 


Active Record 迁移 


e Migration 
e Schema 


e Connection Adapters 


4& : Schema Statements ` Table Definition ` Table 和 Database Statements 


包括 : Model Schema* ` Command Recorder ` Sehema-Dumper 和 Sehema 
e Migrator 
e Schema Dumper 


Connection Handling 连接 数据 库 


用 来 建立 和 数据 库 的 连接 。( 配 置 、 建 立 连接 、 日 志 ， 其 中 的 建立 连接 ， 但 连接 适 配 
不 是 它 做 的 。) 


# 根据 配置 信息 进行 连接 
establish connection 


4 连接 信息 
connection 


通过 establish connection 连接 数据 库 ， 我 们 不 必 加 载 整 个 Rails 环境 ， 仅 使 
用 数据 库 操 作 这 部 分 。 


举例 一 : 


require yaml 
require 'active record' 


dbconfig = YAML::load(File.open( 'config/database.yml')) 

# 这 里 以 development 环境 为 例 

ActiveRecord::Base.establish connection(dbconfig["development"]) 
# ActiveRecord::Base.logger = Logger.new(STDERR) 


class User « ActiveRecord::Base 
# your code here ... 
end 


举例 二 (立即 加 载 基准 测试 脚本 ) : 


require 'rubygems' 
require 'faker' 

require 'active record' 
require 'benchmark' 


# This call creates a connection to our database. 


ActiveRecord::Base.establish connection( 

:adapter => "mysql2", 

host => 7727.0.0.1%, 

username => "root", # Note that while this is the default set 
ting for MySQL, 

:password => "", # a properly secured system will have a diffe 
rent MySQL 

# username and password, and if so, you'll need to 

# change these settings. 

:database => "test") 


# First, set up our database... 
class Category < ActiveRecord: :Base 
end 


unless Category.table_exists? 
ActiveRecord: :Schema.define do 
create_table :categories do |t| 
t.column :name, :string 
end 
end 
end 


Category.create(:name => 'Sara Campbell\'s Stuff') 
Category.create(:name => 'Jake Moran\'s Possessions’) 
Category.create(:name => 'Josh\'s Items') 
number_of_categories = Category.count 


class Item < ActiveRecord: :Base 
belongs_to :category 
end 


# If the table doesn't exist, we'll create it. 


unless Item.table_exists? 
ActiveRecord: :Schema.define do 
create_table :items do |t| 
t.column :name, :string 
t.column :category_id, :integer 
end 


end 
end 


puts “Loading data..." 


item_count = Item.count 
item table size = 10000 


if item count « item table size 
(item table size - item count).times do 
Item.create!(:name -» Faker.name, 


:category id => (i+rand(number_of_categories.to 


zb) 
end 
end 


puts "Running tests..." 


Benchmark.bm do |x| 
[100, 1000, 10000].each do |size| 
x.report "size:#{size}, with n+1 problem" do 
@items=Item.find(:all, :limit => size) 
Qitems.each do |i| 
i.category 
end 
end 
x.report "size:#{size}, with :include" do 
Qitems-Item.find(:all, :include => :category, 
ze) 
Qitems.each do |i| 
i.category 
end 
end 


:limit => si 


require 'active record' 


ActiveRecord::Base.logger - Logger.new(STDERR) 
# ActiveRecord::Base.colorize logging = false 


ActiveRecord::Base.establish connection( 
:adapter => "sqlite3", 
:database => ":memory:" 


ActiveRecord: :Schema.define do 
create_table :albums do |table| 
table.column :title, :string 
table.column :performer, :string 
end 


create_table :tracks do |table| 
table.column :album_id, :integer 
table.column :track_number, :integer 
table.column :title, :string 
end 
end 


class Album « ActiveRecord::Base 
has many :tracks 

end 

class Track « ActiveRecord::Base 


belongs to :album 
end 


connection 使 用 举例 : 


ActiveRecord::Base.connection.table exists? 'some table' 


另外 一 个 使 用 execute 方法 举例 : 


ActiveRecord::Base.connection.execute "ALTER TABLE some table CH 
ANGE COLUMN..." 


其 它 方 法 : 


# 连接 的 配置 信息 


connection config 


# 十 否 已 连接 


connected? 


connection id 
connection id- 


connection pool 


remove connection 
retrieve connection 


Migration 文件 下 的 内 容 
重要 的 如 : 


run 或 migrate 


V 
exec_migration 


V 
revert 
reversible 


revert 内 部 其 它 方法 会 调用 ， 懒 人 复制 、 粘 贴 ， 不 想 改名 字 使 用 。 


He: 


check pending! 
disable ddl transaction! 
load schema if pending! 


reverting? 


run 
migrate 


exec migration 


announce 
connection 

copy 
next_migration_number 
proper table name 

say 

say with time 
suppress messages 
table name options 
write 


主要 命令 


rake db:migrate 
rake db:rollback 


rake db:migrate:up 
rake db:migrate:down 


rake db:migrate:redo 


指定 版 本 号 的 回 滚 


rake db:migrate:down VERSION-20141119130134 


回 滚 最 近 几 个 迁移 


rake db:rollback STEP=n 


n 代表 个 数 。 注 意 : 是 最 近 几 个 ， 它 们 会 被 一 起 移 除 。 
其 它 类 似 命 令 : 


只 执行 指定 版 本 号 的 迁移 


rake db:migrate VERSION=20141119130134 


只 执行 最 近 几 次 迁移 


rake db:migrate STEP=n 


回 滚 、 然 后 重新 执行 最 近 几 次 迁移 


rake db:migrate:redo STEP-n 


say with time 
使 用 举例 : 
def up 
say with time "Updating salaries..." do 
Person.all.each do |p| 
p.update attribute :salary, SalaryCalculator.compute(p) 
end 


end 


end 


Connection Adapters 包含 以 下 这 4 个 模块 ， 及 其 它 多 个 模块 ， 但 在 此 略 过 它们 … 


Schema Statements 
重要 的 操作 或 问 询 如 下 (实例 方法 ) : 


Naex( A 
add_index 
remove_index 
rename_index 
index_exists? 
index_name_exists? 


column (/&'i& ) 
add column 
rename column 
change column 
remove column 
remove columns 
column exists? 


table( x) 
create_table 
drop_table 
rename_table 
change_table 
table_exists? 


add_foreign_key 
remove_foreign_key 
foreign_key_exists? 


add reference & add belongs to 
remove belongs to & remove reference 


其 它 操作 或 问 询 (实例 方法 ) : 


add timestamps 


assume migrated upto version 


change column default 
change column null 


initialize schema migrations table 


create join table 
drop join table 


columns 

foreign keys 

native database types 
remove timestamps 


table alias for 


view exists?(view name) 
views 


其 它 实 例 方法 : 
options include default? 
add index sort order 
rename column indexes 


rename table indexes 


index name for remove 
quoted columns for index 


create table 
可 选 参 数 : 


:id 


create table(:categories suppliers, id: false) do |t| 
t.column :category id, :integer 
t.column :supplier id, :integer 

end 


:primary_key 
# PK 22 5 m] g uid 
create table(:products, primary key: 'guid') do |t| 
# u nm 8 
end 


nl 


# 主键 仍然 是 integer 类 型 

create table :products, id: false do [t| 
t.primary key :sku 

end 


上 述 两 种 解决 方法 类 似 ， 但 它们 类 型 都 是 integer ... 比如 我 们 想 要 string 呢 ， 只 能 
这 样 : 


1) 使 用 SQL 创建 主键 


execute "ALTER TABLE employees ADD PRIMARY KEY (emp id);" 


问题 解决 了 ， 但 另 一 问题 又 来 了 ， 这 么 做 迁移 不 记录 在 委 。 如 果 想 要 记录 ， 我 们 还 
要 


config.active record.schema format = :sql 


显然 ， 这 并 不 是 好 的 做 法 。 
另 一 解法 是 : 


2) 类 似 主键 ， 但 不 是 主键 


create table :employees, :primary key => :emp id do |t] 
t.string :first name 
t.string :last name 

end 

change column :employees, :emp id, :string 


Lit ZA #RÆ AEK primary key > HX string 
另外 ， 


更 改 主键 ， 则 id 和 id= 也 会 做 相应 变化 ， 如 果 你 觉得 别 捏 ， 可 以 重 置 它 们 ( 尽 
管 不 推荐 ) 。 


class Product < ActiveRecord::Base 
# 很 多 方法 都 依赖 于 id， 不 推荐 这 么 做 
def id 
raise NoMethodError, "Please call #{self.class.primay_key} i 
nstead." 
end 


def id=(value) 
raise NoMethodError, "Please call #{self.class.primay_key}= 
instead." 


end 


end 


其 它 地 方 相应 更 改 : 


4 app/models/product.rb 

class Product « ActiveRecord::Base 
4 model 层面 指定 primay_key 
self.primay key = 'sku' 


# €5 to param* 244% params 
def to param 
sku.parameterize 
end 
end 


4 config/routes.rb 

H 路 由 里 使 用 自 定 义 主键 代替 sid 

# 在 这 里 是 prams[:sku] 代替 params[:id] 
resources :products, param: :sku 


p 


Note: i$ 25 > 4$ 1] string 类 型 做 主键 ， 还 没有 好 的 解决 方 


:options 


create table :products, options: "ENGINE=BLACKHOLE" do |t| 
t.string :name, null: false 
end 


:temporary 


create table(:long query, temporary: true, 
as: "SELECT * FROM orders INNER JOIN line items ON order id-or 
ders.id") 


:force 
创建 表 之 前 先 删 除 它 ( 如 果 已 经 存在 同名 表 的 话 )， 确 保 创 建 过 程 是 顺利 的 。 
功能 类 似 : 


drop table :table name if table exists?("table name") 
create table :table name 


:aS 


create_table(:long_query, temporary: true, 
as: "SELECT * FROM orders INNER JOIN line_items ON order_id=or 
ders.id") 


change table 

可 选 参数 : 

:bulk 

尽 可 能 的 将 更 改 表 操作 转换 成 一 条 SQL 语句 ， 一 次 执行 。 


如 下 面 所 示 ， 一 条 SQL 语句 ， 可 完成 多 个 操作 : 


ALTER TABLE "users! ADD COLUMN age INT(11), ADD COLUMN birthdate 
DATETIME ... 


好 处 是 ， 这 可 以 加 快 迁 移 速度 。 


Table Definition 


简单 划分 create table 
使 用 create table 时 ， 传 递 给 block 的 参数 t 就 是 此 类 型 : 
create table :table name do |t| 
4 t.class 


# => ActiveRecord::ConnectionAdapters::TableDefinition 
end 


重要 的 如 : 


column 


而 ot 所 支持 的 数据 类 型 通过 column 对 外 开放 : 


其 它 方法 : 
remove column 


columns 

index 

primary key 

timestamps 

belongs to & references 


Note: 这 里 有 一 些 方 法 是 通过 元 编程 生成 的 ， 查 文档 找 不 到 它们 ， 可 能 通过 
ActiveRecord::ConnectionAdapters::TableDefinition.public instance methods 
(false) BA > 


列举 如 下 : 


: indexes 

: indexes= 
:name 

: temporary 
options 

:as 

: columns 
:primary_key 
:[] 

: column 
:remove column 
:string 
:text 
:integer 
:float 
:decimal 
:datetime 
:timestamp 

: time 

:date 
:binary 
:boolean 

: index 

: timestamps 
:references 
: belongs_to 
:new column definition 


Table 


简单 划分 change table 
使 用 create table 时 ， 传 递 给 block 的 参数 t 就 是 此 类 型 : 
change table :table name do |t| 
4 t.class 


# => ActiveRecord::ConnectionAdapters::Table 
end 


相关 模块 或 方法 ， 可 以 参考 : TableDefinition 和 SchemaStatements#create_table 


支持 的 数据 类 型 或 操作 有 : 


change table :table do |t| 
t.column 

.index 

.rename index 

.timestamps 

„change 

.change default 

.rename 

.references 

.belongs to 

.string 

.text 

.integer 

.float 

.decimal 

.datetime 

.timestamp 

.time 

.date 

.binary 

.boolean 

.remove 

.remove references 

.remove belongs to 

.remove index 
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.remove_timestamps 
end 


除 上 述 外 ， 还 有 : 


column exists? 
index exists? 


change, change default 


remove, remove index, remove timestamps 
remove belongs to & remove references 


rename, rename index 


column 

index 

timestamps 

belongs to & references 


Note: 这 里 有 一 些 方法 是 通过 元 编程 生成 的 ， 查 文档 找 不 到 它们 ， 可 能 通过 
ActiveRecord::ConnectionAdapters::Table.public instance methods(false) & 


看 。 


列举 如 下 : 


: column 

:column exists? 

: index 

: index exists? 
:rename index 

: timestamps 

: change 
:change_default 

: remove 

:remove index 
:remove timestamps 
: rename 
:references 
:belongs to 
remove references 
:remove belongs to 
:string 

:text 

:integer 

:float 

: decimal 

:datetime 

: timestamp 

: time 

: date 

:binary 

:boolean 


Database Statements 
常用 的 如 : 


execute 


有 时 候 ， 我 们 会 在 迁移 文件 里 直接 运行 SQL， 使 用 上 述 方法 ， 可 以 达到 目的 。 


举例 : 


class MakeJoinUnique < ActiveRecord::Migration 
def up 
execute "ALTER TABLE ^pages linked pages' ^n 
ADD UNIQUE '^page id linked page id' (^ page id', lin 
ked page id')" 
end 


def down 
execute "ALTER TABLE ^pages linked pages DROP INDEX ‘page i 
d linked page id'" 
end 
end 


其 它 方法 ， 不 在 此 一 一 列举 。 


Model Schema 
通过 它们 可 以 查看 和 更 改 model 5 table 的 对 应 关系 。 
常用 类 方法 : 

reset column information 

column names 

column defaults 


inheritance column 
inheritance column- 


table name 
table name- 


table exists? 


在 数据 库 层 面 ， 我 们 可 以 给 某 一 列 设 置 默认 值 。 在 model 层面 ， 我们 创 
后 ， 如 果 ile 受 置 对 应 列 的 值 ， 那 保存 的 时 候 存 的 就 是 默认 值 。 
么 ， 怎 么 查看 所 有 列 及 其 在 数据 库 层 面 的 默认 值 呢 。 


column defaults 


= 


查看 所 有 列 的 名 字 : column names 


单 表 继承 时 ， 黑 认 字 段 为 type ,可 以 更 改 它 : inheritance column- 


建 对 象 之 


reset column information 定义 于 Model Schema ， 在 迁移 的 时 候 经 常用 到 。 


整个 迁移 过 程 ， 环 境 只 加 载 一 次 。 但 有 了 时候， 我 们 添加 了 属性 ， 我 们 希望 马上 


填充 数据 。 此 时 ， 就 需要 重新 读 取 model 的 表 信 息 。 


举例 : 


能 够 


class AddPeopleSalary « ActiveRecord::Migration 
def up 
# 添加 属性 
add column :people, :salary, :integer 
# 确保 已 经 添加 了 此 属性 
Person.reset column information 
# 马上 填充 数据 
Person.all.each do |p| 
p.update attribute :salary, SalaryCalculator.compute(p) 
end 
end 
end 


其 它 类 方法 : 


sequence name 
sequence name- 


quoted table name 


content columns 


quoted table name 可 用 命令 的 形式 获取 Model 对 应 的 表 名 。 


sequence name 获取 序列 名 。 


Schema 
继承 于 Migration 


常用 的 如 : 


define 


对 应 的 是 db/schema.rb 里 的 方法 ， 举 例 : 
ActiveRecord::Schema.define(version: 20380119000001) do 


Ic 
end 


再 举例 : 


require 'active record' 

ActiveRecord::Base.establish connection( adapter: 'sqlite3', dat 
abase: ":memory:" ) 

ActiveRecord::Schema.define(version: 1) ( create table(:articles 
) { |t| t.string :title } } 


class Article < ActiveRecord: :Base; end 


Article.create title: 'Quick brown fox' 


其 它 方 法 : 
migrations paths 


Note: € EHRT X44 FE migration 语句 ， 也 就 是 说 直接 让 它 执 行 SQL i$ 4) eH 
行 的 。 


x 


/一 > 
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TODO 


schema format 
config.active record.schema format 决定 生成 什么 Schema 文件 及 其 内 
容 o 


设置 为 :ruby (默认 ) 则 生成 schema.rb 文件 ， 里 面 是 Ruby 代码 ; 
设置 为 sql 则 生成 structure.sql 文件 ， 里 面 是 SQL 代码 。 


同名 方法 如 : 


create table 
drop. table 


index name 

normalize migration number 
normalized versions 
primary key 

table exists? 


table name 


> 
NU 
p 
m 
Cy 


Active Record 约定 、 配 置 ， 


e Model Schema 

e Naming Conventions 
e Schema Conventions 
e Timestamps 

e Core 

e Attribute 


和 属性 的 类 型 转换 有 关 ， 在 Attribute Set BAF] » & Attribute Set LA TA 
E o 


e Attribute Set 
e Attribute Deeeraters 
相对 而 言 较 底层 ， 使 用 Rails 的 话 ， 一 般 不 会 直接 用 到 的 它们 : 
e Connection Handling 
e Serialization 
e Migration DatabaseTasks 


e Statement Cache 


Naming Conventions 


类 映射 表 ， 属 性 映射 列 。 
命名 约定 : 


Model / Class 
Post 
Lineltem 
Deer 
Mouse 


Person 


Table / Schema 
posts 
line items 
deers 
mice 


people 


Schema Conventions 
命名 约定 : 


adi: 解释 


Foreign 外 键 。 前 者 belongs to 后 者 ， 根 据 后 者 所 对 应 的 表 名 ， 为 前 者 生 
keys 成 "后 者 _id" 属 性 。 


p 主键 。 默认 使 用 "jd" 属 性 , 迁移 时 自 动 完成 


除 上 述 属 性 外 ， 约 定 还 有 : 


属性 解释 
created at 创建 record a E a] EX 
updated at 最 后 修改 record 44 E IA] EX 
created_on 创建 record 的 时 间 
updated on 最 后 修改 record 的 时 间 
lock version 使 用 乐观 锁 特 性 的 时 候 会 用 到 
type 使 用 单 表 继承 特性 的 时 候 会 用 到 
(association name) type 使 用 多 态 特性 的 时 候 会 用 到 
(table name) count 使 用 counter. cache 特性 的 时 候 会 用 到 


尽管 这 些 属性 都 是 可 更 改 的 ， 但 强烈 建议 不 要 更 改 它们 ， 使 用 默认 的 即 可 。 
另外 ， 如 果 没 有 使 用 到 上 述 特性 ， 那 么 强烈 建议 不 要 使 用 上 述 属 性 。( 实 在 需要 的 
话 ， 可 以 找 同 义 词 替代 ) 


Timestamps 


时 间 改 包括 created at/created on 和 updated at/updated on 


不 想 生 成 时 间 惟 相关 属性 : 
config.active record.record timestamps = false 
时 间 改 默认 使 用 UTC， 如 果 你 想 使 用 本 地 时 区 : 
config.active record.default timezone = :local 
atk? ActiveRecord 可 以 自动 识别 并 转换 时 区 : 


config.active record.time zone aware attributes = true 


如 果 你 想 取消 此 特性 ， 可 以 配置 为 false 
如 果 你 仍然 想 使 用 此 特性 ， 但 同时 又 有 需要 忽略 此 特性 ， 你 可 以 手动 设置 ， 举 例 : 
class Topic < ActiveRecord::Base 


self.skip time zone conversion for attributes - [:written on] 
end 





Core 


从 原来 的 Base 中 抽取 出 来 单独 成 module， 负 责 部 分 底层 对 接 、 重 写 部 分 常用 方法 
等 。 一 起 抽取 出 来 的 还 有 Model 模块 (包含 include ` extend 等 ， 现 已 经 被 删除 ) 


包含 时 即 执行 : 
mattr accessor :logger, instance writer: false 
self.configurations 


mattr accessor :default timezone, instance writer: false 

mattr accessor :schema format, instance writer: false 

mattr accessor :timestamped migrations, instance writer: false 
mattr accessor :dump schema after migration, instance writer: fa 
lse 

mattr accessor :maintain test schema, instance accessor: false 


class attribute :default connection handler, instance writer: fa 


lse 
class attribute :find by statement cache 


实例 方法 : 


<=> 
== & eql? 


clone 
dup 


connection_handler 


encode with 
init with 


freeze 
frozen? 


hash 

inspect 
pretty print 
readonly! 
readonly? 


slice 


self.allocate 和 init with 使 用 举例 : 


class Post < ActiveRecord::Base 
end 


post - Post.allocate 


post.init with('attributes' => ( 'title' => 'hello world' }) 
post.title # => 'hello world' 


类 方法 一 : 


allocate 

find 

find by 

find by! 

generated association methods 


inherited 


initialize find by cache 
initialize generated modules 


inspect 


类 方法 二 : 


configurations 
configurations- 


connection handler 
connection handler- 


new 


获取 record 对 象 


归结 起 来 ， 有 两 种 方式 可 以 获得 record 对 象 : 1) 从 数据 库 里 获取 2) 程序 新 创建 


前 者 可 以 通过 各 种 方法 查询 得 on f init with 
后 者 也 可 以 通过 各 种 方法 创 ve ， 但 都 是 封装 了 initialize 
# 查询 得 到 。 从 SQL 层面 转向 到 Ruby 层面 


def find by sql(sql, binds - []) 
result set = connection.select all(sanitize sql(sql), "#{name} 
Load", binds) 
column types - result set.column types.dup 


result set.map { |record| instantiate(record, column types) } 
end 


instantiate 查询 得 到 ， 等 价 于 : self.allocate + init with 


o 


def instantiate(attributes, column types = {}) 

klass - discriminate class for record(attributes) 

attributes - klass.attributes builder.build from database(attr 
ibutes, column types) 

klass.allocate.init with('attributes' -» attributes, 'new reco 
rd' => false) 


end 

def allocate 
define_attribute_methods 
super 


end 


def init with(coder) 
Qattributes - coder['attributes'] 


init internals 
Qnew record = coder['new record' ] 
self.class.define attribute methods 


run find callbacks 
run initialize callbacks 


self 
end 


initialize 创建 得 到 ， 比 如 : new 或 build 


User.new(first name: 'Jamie') 


def initialize(attributes = nil, options = {}) 
@attributes = self.class. default attributes.dup 
self.class.define attribute methods 


init internals 
initialize internals callback 


init attributes(attributes, options) if attributes 
yield self if block given? 


run initialize callbacks 
end 


前 者 ， 也 就 是 查询 得 到 ， 一 定 有 persisted? # => true 
后 者 ， 也 就 是 创建 得 到 ， 一 定 有 persisted? # => false 


其 它 类 似 : 


clone 
dup 


initialize dup 
clone 


user - User.first 
new user - user.clone 


user.name # => "Bob" 

new_user.name = "Joe" 

user .name # => "Joe" 

user.object id == new user.object id 4 => false 
user.name.object id == new user.name.object id # => true 

user.name.object id == user.dup.name.object id # => false 


encode with 


获取 record 对 象 


class Post < ActiveRecord::Base 


end 

coder = {} 

Post .new.encode_with(coder ) 

coder # => {"attributes" => {"id" => nil, ... }} 
init_with 


class Post < ActiveRecord: :Base 
end 


post = Post.allocate 
post.init with('attributes' => { 'title' => 'hello world' }) 
post.title # => ‘hello world' 


参考 


ActiveRecord 对 象 的 拼装 

Read and Write Activerecord Attribute 

ActiveRecord Object Instantiate 

Using Allocate to Create ActiveRecord Objects When Stubbing find by sql 
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Serialization 


有 ActiveRecord::Serializers::JSON 提供 : 


serializable hash(options = nil) 方法 。 
效果 和 as json 差不多 。 实 际 起 作用 的 是 ActiveModel::Serialization 里 的 同名 方 
法 。 


有 ActiveRecord::Serializers::XmlSerializer 提供 : 


to xml 方法。 实现 方式 : include and extend ActiveModel::Serializers::Xml » # 
且 里 面 有 同名 方法 。 


Note: 包括 了 XmlSerializer. 


Rails 5 里 ActiveRecord::Serialization::XmlSerializer 已 废除 。 


Database Tasks 


rake db:migrate 等 迁移 命令 ， 定 义 在 Active Record 的 databases.rake Zo X 
中 ， 大 部 分 命令 都 是 由 ActiveRecord::Tasks::DatabaseTasks 来 处 理 ， 再 或 者 转发 
到 其 它 模块 。 


提供 接口 如 下 : 


+ 
E 


create current rake db:create 


dk 
EV 


create all rake db:create:all 





drop current # 对 应 rake db:drop 
drop_all # 对 应 rake db:drop:all 
purge_current # 对 应 rake db:purge 
purge all # 对 应 rake db:purge:all 
migrate # 对 应 rake db:migrate 


charset current 4 对 应 rake db:charset 





collation current # 对 应 rake db:collation 


其 它 接口 ， 不 在 此 一 一 列举 : 


charset 

check schema file 

collation 

create 

current config 

db dir 

drop 

env 

fixtures path 

load schema, load schema current 
load seed 

migrations paths 

purge 

register task 

root 

seed loader 

structure dump, structure load 


Statement Cache 


提供 create(connection, block = Proc.new) RAK: 


cache = StatementCache.create(Book.connection) do |params | 
Book.where(name: "my book").where("author_id > 3") 
end 


通过 它 可 以 缓存 某 些 数据 库 操 作 ( 和 Relation 有 点 类 似 ) 。 


提供 execute(params, klass, connection) 实例 方法 : 


cache.execute([], Book, Book.connection) 
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Collection Cache Key 
给 Relation 集合 也 可 以 有 cache key * f|» : 
blogs = Blog.where("id > 2"); 
blogs.collection cache key 
(0.2ms) SELECT COUNT(*) AS size, MAX("blogs"."updated at") A 
S timestamp 


FROM "blogs" WHERE (id » 2) 
# => "blogs/query-9a5d6ea830ba519707ab5aaf189b9a1b1-0" 


ActiveRecord: :Base#cache_key 封装 了 它 ， 所 以 直接 用 cache key 即 可 。 


Attribute Mutation Tracker 


是 "Dirty - 跟踪 对 象 值 的 变化 情况 "的 内 部 组 成 部 分 之 一 。 


Attribute Decorators 
提供 以 下 两 方法 : 
decorate attribute type(column name, decorator name, &block) 


decorate matching attribute types(matcher, decorator name, &bloc 
k) 


e type 
包括 所 有 支持 的 数据 类 型 
e Railtie 
e errors 
e Base 
e FixtureSet 
fixtures/ 18 X » 
e tasks 


包括 Database Tasks > & MySQL Database Tasks ` PostgreSQL Database 
Tasks » SQLite Database Tasks. 


e databases.rake (很 重要 ) 
@ Explain 


explain 方法 的 底层 实现 (尽管 是 调用 数据 库 的 explain...) 


Active Support autoload 的 类 和 模块 


TODO 


Autoload 
延迟 加 载 (自动 加 载 ) 和 预 加 载 (立即 加 载 )。 
常用 方法 : 

autoload 


eager autoload 


eager load! 


使 用 require Zr 3 


require "some/library" 


使 用 require ,如 果 此 前 没有 加 载 过 ， 则 加 载 并 返回 true; 如 果 此 前 已 经 加 载 过 ， 
则 返回 false. 
(区 别 于 load > load 每 次 都 会 加 载 。 没 有 返回 true/false HMA) 


使 用 require 面临 的 问题 


bala 意味 着 "立即 加 载 所 有 "， 一 开始 这 很 美好 ， 但 随 着 项 目的 成 长 ， 启 动 速度 就 
变 得 很 慢 。 因 为 我 们 并 没有 丨 正 使 用 到 "所 有 "文件 ， 但 却 需 要 加 载 。 


并 且 ，require 不 是 线程 安全 的 。 
使 用 autoload 自动 加 载 (延迟 加 载 ) 


module Foo 
autoload :Bar, "path/to/bar" 
end 


使 用 autoload ， 相 当 于 先 声明 要 加 载 的 模块 (纪录 在 (Q) autoloads) > AL S 
的 时 候 才 会 加 载 。 


autoload 本 质 还 是 require, 只 是 把 "加 载 " 细 分 为 "声明 + 加 载 "。 


使 用 autoload 面临 的 问题 


多 线程 时 ， 这 又 会 引出 一 个 新 问题 。 就 是 在 一 个 线程 里 需要 此 模块 ， 此 时 会 加 载 ( 返 
E true)。 在 这 之 后 ， 另 一 个 线程 也 需要 此 模块 ， 此 时 会 加 载 ， 但 是 因为 前 一 个 线程 
已 经 加 载 过 了 ， 所 以 这 里 会 失败 (返回 false). 


也 就 是 说 ，autoload 不 是 线程 o (准确 点 ， 应 该 是 Ruby 2.0 之 前 的 版 本 不 是 
线程 安全 的 ) 


使 用 eager_autoload 


为 每 个 线程 声明 一 下 要 加 载 的 模块 (纪录 在 各 自 的 @ autoloads) > Mik Xj AAR 
才 会 加 载 。 因 为 每 个 线程 都 有 声明 ， 所 以 一 个 线程 是 否 加 载 ， 并 不 会 影响 另 一 
T 


并 且 ， 很 好 的 解决 了 Ruby 昌 版 本 不 运行 autoload 的 困境 。 
使 用 举例 


module MyLib 
extend ActiveSupport::Autoload 


autoload :Model 
eager autoload do 
autoload :Cache 


end 
end 


MyLib.eager load! 


He CA IK 


除 上 述 常 用 方法 外 ， 还 有 : 


autoload at 
autoload under 


autoloads 


X T autoload paths 和 eager load paths 
原因 : 


e 开发 环境 ， 启 动 速度 要 快 (不 完整 也 没关系 ) 

e 生产 环境 ， 项 目 要 完整 (启动 速度 om 

e 开发 环境 ， 经 常 更 改 代 码 ， 不 用 重启 就 能 运 

e 生产 环境 ， 假 设 不 能 /不 会 更 改 代码 

e 旧版 本 使 用 自动 加 载 还 面临 线程 安全 问题 ， 在 这 生产 环境 是 不 能 忍受 的 


怎么 自动 加 载 ? 


eager load 


epee a hh -r A 
Lt | Ad oce XS p 


eager load paths 
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autoload paths 


例外 : app/ 既 在 autoload paths, 又 在 eager load paths. 
什么 情况 下 ， 你 配置 了 也 没 用 ? 


开发 环境 配置 立即 加 载 ， 仍 然 按 自 行 
生产 环境 下 只 配置 自动 加 载 ， 为 了 线程 安全 等 考虑 ， 需 要 再 加 上 立即 加 载 。 


根据 环境 ， 互 相 影响 


在 开发 环境 ， 使 用 eager load paths 会 影响 autoload_paths， 等 同 于 使 用 
autoload paths ; 
在 生产 环境 不 影响 ， 按 照 它 本 来 的 意思 运行 。 


使 用 autoload paths 始终 不 影响 eager. load paths. 


注意 : 上 述 表 达 是 不 严谨 的 |! 


即使 是 生产 环境 下 ， 大 部 分 情况 使 用 autoload paths 代替 eager load paths 也 是 
可 以 工作 的 ， 但 会 存 循 环 依赖 等 风险 ， 偶 和 尔 会 出 问题 。 
所 以 ， 如 果 你 要 延迟 加 载 ， 推 荐 一 直 使 用 eager load paths. 


直接 对 lib/ 用 eager load paths ? 


想法 : 反正 在 开发 环境 是 自动 加 载 ， 在 生产 环境 是 立即 加 载 。 
Jk35 : 用 的 是 lib/ rb 模式 ， 生 产 环 境 会 把 多 余 的 tasks ^ generators 也 立即 加 载 
了 。 除 非 你 不 在 乎 。 


require dependency 如 何 使 用 ? 


initializers 和 tasks 只 执行 一 次 。 


Lazy Load Hooks 


允许 Rails 延迟 加 载 部 分 组 件 ， 从 而 加 快 应 用 的 局 动 速度 。 


类 方法 : 


on load 
run load hooks 


execute hook 


使 用 举例 : 


4 on load 方法 触发 标识 及 内 容 
initializer 'active record.initialize timezone' do 
ActiveSupport.on load(:active record) do 
self.time zone aware attributes - true 
self.default timezone - :utc 
end 
end 


& run load hooks 方法 执行 
ActiveSupport.run load hooks(:active record, ActiveRecord::Base) 


单独 使 用 举例 : 


require 'active support/lazy load hooks' 


class Say 
def initialize(name) 
@name = name 


ActiveSupport.run_load_hooks(:instance_of_color, self) 
end 
end 


ActiveSupport.on_load :instance_of_color do 
puts "Hi #{@name}" 


end 


Say .new("kelby" ) 
# => "Hi kelby" 


在 Rails 框架 源 代 码 里 ， 大 量 使 用 了 它 。 


Concern 

可 以 方便 快捷 的 扩展 某 个 类 或 模块 ， 并 且 处 理 了 潜在 的 依赖 问题 。 

作用 有 二 : 

1) 更 简洁 、 明 了 的 语法 。 

2) 更 好 的 处 理 模块 之 间 的 依赖 关系 ， 规 避 潜 在 的 模块 之 间 的 循环 依赖 。 

约定 : ClassMethods 和 class methods 自动 继承 、 实 例 方法 自动 包含 、 自 动 使 用 
class eval. 

原来 你 需要 手动 写 included 或 extended 里 面 的 代码 ， 有 实例 方法 、 类 方法 的 话 ， 
也 要 手动 包含 或 继承 ; 现在 按照 约定 来 即 可 。 


以 前 : 


Concern 


module M 
def self.included(base) 
base.extend ClassMethods 


base.class eval do 
# 执行 某 些 方法 
scope :disabled, -> { where(disabled: true) } 


H 执行 茶 些 方法 
include InstanceMethods 
end 
end 


# 定义 类 方法 

module ClassMethods 
H o. 

end 


# 定义 实例 方法 

def a instance method 
eus 

end 


# 如 果实 例 方 法 比较 多 ， 可 以 单独 成 module， 对 应 上 面 的 include InstanceM 


ethods 
module InstanceMethods 
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Concern 


require 'active support/concern' 


module M 
extend ActiveSupport::Concern 


included do 
# 执行 某 些 方法 
scope :disabled, -> ( where(disabled: true) } 


# 执行 某 些 方法 
include InstanceMethods 
end 


PEUR 去 

module ClassMethods 
F Vu 

end 


# 定义 实例 方法 

def a instance method 
Ho... 

end 


# 如 果实 例 方 法 比较 多 ， 可 以 单独 成 module， 对 应 上 面 的 include InstanceM 
ethods 
module InstanceMethods 


nd 
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File Update Checker 


文件 更 新 检测 (文件 更 新 后 ， 不 用 重启 自动 编译 、 生 效 ) 。 
Rails 默认 有 3 个 : 


e i18n reloader(I18n 78 X) 
e routes updater(Routes 18 X) 
e file watcher( 其 它 所 有 ) 


我 们 定制 的 可 以 直接 使 用 Rails.configuration.file watcher 放 到 "其 它 所 
有 "里 ， 也 可 以 直接 调用 ActiveSupport::FileUpdateChecker. 


Lf Za Dh SER 4A \ 


# EN REA paths BUR SS eh LAY SC FF RE OR (PT AE P] RAS ) 
i18n reloader = ActiveSupport: :FileUpdateChecker.new(paths) do 
I18n.reload! # 监视 内 容 有 变化 时 ， 执 行 什么 操作 


# Rails.application.reload routes! 
FI = 





end 
ActionDispatch::Reloader.to prepare do # to prepare 的 作用 ， 可 参 3 
i18n reloader.execute if updated 
end 
i18n reloader.execute 
可 用 Rails.application.reloaders 查看 所 有 检测 器 (要 先 放 进来 ， 才 能 查 


看 ) 。 


Rails.application.reloaders << i18n_reloader 


除 上 述 方法 外 ， 还 有 : 


updated? 


用 于 询问 监视 的 文件 /目录 是 否 有 变化 。 


Notifications 


发 布 、 订 阅 功能 。 怎 么 使 用 ? 


e subscribe - 订阅 
e instrument - X 7j 


# 发 布 消息 
ActiveSupport::Notifications.instrument('render', extra: :inform 
ation) do 
# 下 面 是 真正 要 执行 的 内 容 
render text: 'Foo' 
end 


# 订阅 消息 
ActiveSupport::Notifications.subscribe('render') do |name, start 
, finish, id, payload| 

4 以 下 4 个 属性 是 notification 自 带 的 
name # => 类 型 是 字符 串 ， 代 表 notification 的 名 字 ( 在 这 里 是 'rende 
ae 


RM 
ls 


start # => 类 型 是 Time， 代 表 上 面 开 始 " 执 行内 容 " 的 时 间 
finish # => 类 型 是 Time， 代 表 上 面 结束 "执行 内 容 " 的 时 间 
id # => X 


u) 








RM 
ls 


XX String, %-#% ID X5 notification 


# 以 下 属性 对 应 着 instrument 里 的 extra 
payload # => 类 型 是 Hash， 也 就 是 上 面 传递 过 来 的 参数 
end 


Note: 可 以 按 正则 规则 进行 "订阅 "。 


为 什么 使 用 ? 


Rails 内 外 ， 都 有 很 多 类 似 、 可 替换 的 技术 。 但 这 个 方法 ， 即 能 保证 在 同一 项 目 内 
进行 ， 又 能 使 耦合 度 尽 可 能 的 降低 。 并 且 ， 它 使 用 范围 很 广 。 


缺点 : 配置 不 方便 ， 一 启动 就 执行 ， 并 且 更 改 要 重启 。 黑 认 对 性 能 是 有 影响 的 ， 
subscribe 并 不 是 异步 执行 。 


Rails mend Instrumentation > R TAA 5 instrument 直接 subscribe 它们 。 
或 者 ， 你 自己 写 instrument * RE subscribe. 


有 以 下 特点 : 


e WKS? HABE 
e 操作 简单 
e 随处 可 用 
实现 : 运用 中 间 变 量 notifier. 
Note: 注意 使 用 场景 。 这 里 并 不 是 严格 的 发 布 者 、 订 阅 者 模型 ， 你 从 它们 的 方 
法 名 及 默认 参数 就 应 该 知道 。 


在 控制 台 里 ， 可 运行 以 下 命令 ， 查 看 Rails 项 目 里 有 哪些 instrumenter : 


ActiveSupport::Notifications.instrumenter.class 
# => ActiveSupport::Notifications::Instrumenter 


fanout = ActiveSupport::Notifications.instrumenter.instance vari 
able_get("@notifier") 


fanout.class 


# => ActiveSupport::Notifications: :Fanout 


fanout.instance_variable_get("@subscribers").map do |s] 
s.instance variable get "Qpattern" 
end 


Note: 此 命令 包含 的 instrumenter 并 不 完整 。 比 如 : 元 编程 创建 的 
instrumenter 就 不 包含 。(Action Controller 有 很 多 instrumenter 都 是 元 编程 生 


成 的 ) 
所 有 方法 : 


instrument 
instrumenter 


publish 
subscribe 


subscribed 
unsubscribe 


Rails 默认 已 有 的 instrumenter 


action mailer 


deliver.action mailer 
receive.action mailer 
process.action mailer 


action controller 


write fragment.action controller 
read fragment.action controller 

exist fragment?.action controller 
expire fragment.action controller 


start processing.action controller 
process action.action controller 
send file.action controller 

send data.action controller 
redirect to.action controller 
halted callback.action controller 


unpermitted parameters.action controller 


deep munge.action controller 


action view 


render collection.action view 
render partial.action view 


render template.action view 


active job 


perform start.active job 
perform.active job 


enqueue at.active job 
enqueue.active job 


active record 


instantiation.active record 
sql.active record 


active support 


cache read.active support 
cache generate.active support 
cache fetch hit.active support 
cache write.active support 
cache delete.active support 
cache exist?.active support 


cache delete matched.active support 


cache increment.active support 
cache decrement.active support 


cache cleanup.active support 
cache prune.active support 


rails 


deprecation.rails 


railties 


load config initializer.railties 


Rails 默认 已 有 的 instrumenter 


参考 


Active Support Instrumentation 
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Subscriber 


只 需 继承 于 它 ， 并 定义 同名 方法 ， 然 后 attach to 即 可 。 


Ir 


类 方 》 
attach to 
method added 


subscribers 


attach to 会 把 子 类 里 的 实例 方法 让 Notifications 的 实例 对 象 进行 subscribe ( 调 
用 add event subscriber) ° 


其 它 类 方法 : 


add event subscriber 


add event subscriber 核心 实现 。 


实例 方法 : 


start 
finish 


使 用 举例 : 


module ActiveRecord 
class StatsSubscriber « ActiveSupport::Subscriber 
def sql(event) 
Statsd.timing("sql.#{event.payload[:name]}", event.duratio 
n) 
end 
end 
end 


ActiveRecord::StatsSubscriber.attach to :active record 
使 用 到 了 Notifications > R #k-F Notifications 里 面 的 "订阅 "。 本 质 还 是 Notifications 
的 订阅 ， 只 是 为 了 方便 使 用 而 创建 出 来 的 。 


Note: 原 Notifications 的 instrument 不 变 ， 但 subscribe AMMT > PTAA A 
Subscriber 以 及 它 的 各 个 子 类 。 


Log Subscriber 
继承 于 Subscriber. 


Rails 各 个 模块 里 的 LogSubscriber 


| 
V 


LogSubscriber 


| 
V 


Subscriber 
RAK: 
flush all! 


log subscribers 


logger 


实例 方法 : 


finish 
start 


logger 


其 它 实例 方法 : 


Info 
debug 
warn 
error 
fatal 
unknown 


Log Subscriber 


和 


color 


使 用 举例 : 


module ActiveRecord 
class LogSubscriber « ActiveSupport::LogSubscriber 
def sql(event) 
"Z(event.payload[:name]? (#{event.duration}) #{event.paylo 
ad[:sq1l]}" 
end 
end 
end 


ActiveRecord::LogSubscriber.attach to :active record 
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Action Mailer Log Subscriber 


日 志 记 录 ， 继 承 于 ActiveSupport::LogSubscriber， 执 行 哪个 方法 时 想 要 记录 日 
志 ， 只 需要 创建 和 它 同 名 方法 ， 然 后 打印 日 志 即 可 。Log Subscriber 章节 会 讲 到 。 


目前 Rails 侦 听 以 下 方法 : 


deliver # 发 送 
receive # 
process ; 


除 上 述 方法 外 ， 还 有 : 


logger 


Action Controller Log Subscriber 


deep. munge 
halted callback 
process action 
redirect to 


send data 
send file 


start processing 


unpermitted parameters 


read fragment 
write fragment 
expire fragment 


exist fragment? 


write page 
expire page 


除 上 述 方法 外 ， 还 有 : 


logger 


Action View Log Subscriber 


from rails root 

rails root 

render collection & render partial & render template 
除 上 述 方法 外 ， 还 有 : 


logger 


Active Record Log Subscriber 
RAK: 


runtime 
runtime= 


reset_runtime 
实例 方法 : 

odd? 

render_bind 

sql 

除 上 述 方法 外 ， 还 有 : 


logger 


Rescuable 


类 方法 : 
rescue from(*klasses, &block) 


klasses 表示 一 个 或 多 个 异常 类 。 如 果 有 with 选项 ， 则 用 其 value( 一 般 是 个 方法 ) 
处 理 ; 否则 ， 需 要 传递 block 来 处 理 。 


class ApplicationController < ActionController::Base 

# 一 个 或 多 个 异常 类 ， 有 :with 选项 

rescue from User::NotAuthorized, with: :deny access # HL 454 
常 处 A A 法 


rescue from ActiveRecord::RecordInvalid, with: :show errors 


# 一 个 或 多 个 异常 类 ， 传 递 block 

rescue from 'MyAppError::Base' do |exception| 
render xml: exception, status: 500 

end 


protected 
def deny access 


+: 
TE 


end 


def show_errors(exception) 
exception.record.new_record? ? 
end 
end 


实现 : 类 似 ' 实 例 变 量 的 运用 '， rescue from 把 硕 望 捕 提 的 异常 类 放 到 一 个 变量 
(rescue_handlers) 里 。 抛 出 异常 时 ， 会 对 异常 进行 检查 (rescue_with_handlem， 如 
果 抛 出 的 异常 恰好 被 包含 在 这 个 变量 (rescue_handlers)， 则 用 我 们 的 方式 进行 处 
38 o 


实例 方法 : 


handler for rescue 


rescue with handler 


Descendants-Tracker 


查看 某 个 类 的 子 类 。 功 能 上 和 Ruby AE Object Space 类 似 ， 但 性 能 上 要 比 它 
好 得 多 。 


class A 
extend ActiveSupport::DescendantsTracker 
end 


class B < A 
end 


class C « A 
end 


class D « B 
end 


A.descendants 
-» [B, D, C] 


+ 输出 A 的 所 有 直接 子 类 
A.direct descendants 
-» [B, C] 


手法 : 重 写 inherited 方法 ， 当 发 生 继 承 关 系 时 ， 记 录 到 QOdirect descendants 
里 。 


Dependencies 
依赖 。 
Class Cache 

[] & get 

clear! 

empty? 

key? 

safe get 


store 


Watch Stack 


each 

new constants 
watch namespaces 
watching? 


3: 


自动 加 载 会 从 app/models, app/controllers, lib/ and other load paths. + Ze X * 40K 


没有 会 : 


# in active support/dependencies.rb 

def const missing(const name) 
from mod - anonymous? ? guess for anonymous(const name) : self 
Dependencies.load missing constant(from mod, const name) 

end 


AS: 


#lib/active_support/dependencies.rb:477 
expanded = File.expand_path(file_path) 
expanded.sub!(/N.rbNz/, '') 


if loading. include?(expanded) 

raise "Circular dependency detected while autoloading constant 
#{qualified_name}" 
end 


| | 
此 处 有 魔法 。 


Active Support eager autoload 的 类 和 模块 


TODO 


Cache 缓存 的 源头 
RAK: 
expand_cache_key(key, namespace = nil) 


让 cache key 过 期 。 


使 用 举例 : 
expand cache key([:foo, :bar]) # => "foo/bar" 
expand_cache_key([:foo, :bar], "namespace") # => "namespace/foo 
/bar" 


lookup store(*store option) 
指定 缓存 存储 方式 。 
使 用 举例 : 


ActiveSupport::Cache.lookup store(:memory store) 
# => 返回 一 个 ActiveSupport::Cache::MemoryStore Føst% 


ActiveSupport::Cache.lookup store(:mem cache store) 

# => 返回 一 个 ActiveSupport::Cache::MemCacheStore XI] +R 
Store 
操作 的 对 象 是 下 面 的 entry 


是 FileStore, MemCacheStore, MemoryStore, NullStore 以 及 LocalStore 的 基 类 ， 
某 些 方法 需要 子 类 重 写 才 有 意义 。 


实例 方法 : 


cleanup 
clear 


decrement 
increment 


delete 
delete matched 


exist? 
mute 

read 

write 

read multi 
fetch 


fetch multi 


silence! 


fetch 使 用 举例 : 


cache.write('today', 'Monday') 
cache.fetch('today') # => "Monday" 


cache.fetch('city') # => nil 
cache.fetch('city') do 
'Duckburgh' 
end 
cache.fetch('city') # => "Duckburgh" 


key_matcher 


1) File Store (文件 存储 ) 


cleanup 
clear 


decrement 
increment 


delete matched 


2) Mem Cache Store (缓存 存储 ) 


clear 
read multi 


stats 


3) Memory Store (内 存 存储 ) 


cleanup 
clear 
prune 


decrement 
increment 


delete matched 
pruning? 


4) Nutt Store 


不 使 用 任何 介质 进行 存储 ， 在 开发 、 测 试 环境 可 能 有 用 。 


Local Cache (4-64 4 


使 用 上 述 的 几 种 介质 进行 存储 ， 再 快 ， 也 没有 直接 使 用 内 存 来 得 快 。 上 述 几 种 介质 
存储 只 要 实现 "本 地 缓存 "， 那 么 在 一 个 block 里 首次 调用 变量 时 ， 会 备份 它 到 本 地 

缓存 ， 之 后 在 block 里 再 次 调用 (相同 cache key)， 则 直接 使 用 本 地 缓 起 来 存 的 ， 在 
这 性 能 上 比 之 前 又 更 快 了 一 点 。 


Local Cache 
简单 的 in-memory 缓存 。 
实例 方法 : 

middleware 


with local cache 


set cache value 


属于 middleware, rake middleware 里 就 能 看 到 ， 并 且 一 开始 就 执行 了 。 
Local Store 
简单 的 memory 存储 。( 非 线程 安全 ) 

clear 


delete entry 
read entry 
write entry 


Entry 


表示 某 一 条 cache 数据 ， 包 含 了 值 和 过 期 时 间 等 信息 。 


Callback 方法 解释 及 使 用 


这 里 是 Rails 所 有 回调 的 源头 。 从 表面 看 ， 它 提供 以 下 方法 。 


类 方法 : 
define callbacks 


set_callback 
skip_callback 


reset callbacks 


实例 方法 : 


run callbacks 


已 有 回调 类 型 : 


CALLBACK FILTER TYPES = [:before, :after, :around] 


使 用 过 程 中 ，3 个 必 不 可 少 的 方法 及 其 解释 如 下 : 


方法 解释 
define_callbacks — 定义 一 条 "回调 链 "。 


把 某 种 类 型 的 "回调 " 放 到 "回调 链 "里 d 
set callback 需要 3 个 参数 : 回调 链 的 名 字 、 回 调 的 类 型 (不 传递 的 话 ， 
自动 使 用 :before)、 回 调 的 名 字 。 


在 执行 代码 的 前 后 ， 执 行 指定 "回调 链 "相关 的 "回调 "。 
run callbacks 第 一 个 参数 是 "回调 链 "的 名 字 ， 第 二 个 参数 是 个 block， 里 
HL EAT AY ARAG o 


使 用 举例 : 


Callback 方法 解释 及 使 用 


class Report 
include ActiveSupport::Callbacks 


# 定义 一 条 回调 链 ， 名 字 是 print 
define callbacks :print 


# 把 类 型 为 before’ 27% before print 的 回调 ， 放 到 print 回调 链 里 
set callback :print, :before, :before print 

# 把 类 型 为 after’ 27% after print 的 回调 ， 放 到 print 回调 链 里 
set callback :print, :after, :after print 


def print me 
# EIT" BE RANT AG RS ^ TAT print 回调 链 里 的 回调 
run_callbacks :print do 
# BIE RATA RG 
p "print me' 
end 
end 


# 以 下 两 方法 已 经 放 入 print 回调 链 ， 所 以 会 被 调用 。 


def before print 
p 'before print' 


def after print 
p 'after print' 


Report.new.print me 
4 => "before print" 
# => "print me" 

# => "after print" 
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Callbacks 底层 简要 分 析 


ActiveSupport::Callbacks 本 身 可 分 为 几 部 分 。 


Callback Chain 回调 链 


define callbacks 主要 作用 就 是 定义 一 条 "回调 链 "， 每 一 条 链 都 是 Callback 
Chain 的 实例 对 象 。 
Callback Chain 实例 对 象 ， 大 致 如 下 : 
H«ActiveSupport::Callbacks::CallbackChain:0x007fc6ebf70648 
@callbacks=nil, 
@chain=[], 
@config={:scope=>[:kind]}, 


@mutex=#<Mutex:0x007fc6ebf70580>, 
@name=:checkout> 


其 中 ， 最 重要 的 信息 有 : 
e @chain 此 回调 链 所 包含 的 "所 有 回调 "。 
e (name 此 回调 链 的 "名 字 "。 
Rails 没有 提供 查看 所 有 callback chain 信息 的 接口 ， 只 能 间接 查看 。 


比如 : 


callback_chains = ObjectSpace.each object(ActiveSupport::Callbac 
ks: :CallbackChain) 


chains = callback chains.select[|cc| cc.instance variable get('O 
chain").present? } 


callback chains uniq name - chains.map(&:name).uniq 


但 对 于 茶 个 类 而 言 ， 则 很 方便 。 如 : 


callback chains = ClassName.singleton methods.select do |method| 
method.to s =~ /^ [^ ].-* callbacks$/ 
end 


# Rails model 默认 有 callback chains: 
: save callbacks 

: create callbacks 

: update callbacks 

: validate callbacks 

: validation callbacks 
: initialize callbacks 
: find callbacks 

: touch callbacks 

: destroy callbacks 

: commit callbacks 

: rollback callbacks 


callback chain f/8 ° t : 


User. save callbacks 


Callback 回调 


上 面 提 到 每 一 条 回调 链 的 (chain 里 包含 了 它 " 所 有 的 回调 "， 这 里 的 每 一 个 "回调 "就 
是 一 个 Callback 实例 对 象 。 


Callback 实例 对 象 ， 大 致 如 下 : 


#<ActiveSupport::Callbacks: :Callback:0x007fc6f2162248 
@chain_config={:scope=>[:kind]}, 
Qfilter-Z«Proc:0x007fc6f2162388Q/Users/.../lib/rails/applicati 

on/finisher.rb:100>, 
@if=[], 
@key=70246220894660, 
@kind=:before, 
@name=:prepare, 
@unless=[ ] 


其 中 ， 最 重要 的 信息 有 : 
e @if 或 Qunless 此 回调 起 作用 的 "前 提 条 件 "。 


e @kind 此 回调 的 "回调 类 型 "。( 对 于 Rails 而 言 ， 可 以 选择 :before, :after, 
:around 其 中 之 一 ) 


e @name 此 回调 所 加 入 的 "回调 链 的 名 字 "。 
© @key 此 回调 的 "名 字 "。( 如 果 没 有 名 字 则 用 object id R) 


e Qfilter 此 回调 " 丨 正 要 执行 的 代码 "。( 一 般 只 显示 名 字 ， 也 就 是 说 和 (key 
一 样 ; 如 果 没 有 名 字 ， 则 显示 定义 它 时 的 文件 及 行 号 ) 


"站 正 要 执行 的 代码 " , 可 以 是 以 下 类 型 : 


Symbols:: 方法 名 。 
Strings:: 可 求 值 的 字符 串 。 
Procs:: proc 对 象 。 
Objects:: 普通 的 实例 对 象 ， 但 必需 有 before x, around x, after x 等 " 回 
调 "方法 。 

因为 ， 之 后 会 以 拼接 字符 串 的 形式 ， 找 出 对 应 的 回调 方法 ， 然 后 send A 
He 


其 实 ， 还 有 一 种 类 型 Conditionals 但 被 直接 跳 过 了 ， 所 以 不 算 在 内 。 


这 些 不 同类 型 的 "站 正 要 执行 的 代码 "， 之 后 都 会 被 Callback 的 make lambda > 
法 转换 成 lambda 对 象 ， 再 然后 处 理 过 程 类 似 。 
4 @filter 是 一 个 实例 对 象 ， 并 且 恰 好 有 和 "回调 类 型 "相同 的 方法 


上 面 也 提 到 "回调 类 型 "，Rails AUF :before ^ :after 和 :around. 

上 面 提 到 了 回调 里 " 申 正 要 执行 的 代码 "可 以 是 一 个 实例 对 人 象 ， 当 触发 回调 时 ， 会 执 
行 它 的 同名 "回调 "方法 。 

Her @filter 恰好 是 一 个 实例 对 象 ， 而 这 个 实例 对 象 又 恰好 有 before ` after 或 
:around， 则 此 时 会 出 现 和 想像 中 不 一 样 的 结果 。 


比如 : 


require 'active support' 


class Audit 
def before(caller) 
puts 'Audit: before is called' 
end 


def before save(caller) 
puts 'Audit: before save is called' 
end 
end 


class Account 
include ActiveSupport::Callbacks 


define callbacks :save 
set callback :save, :before, Audit.new 


def save 
run callbacks :save do 
puts 'save in main' 
end 
end 


end 


Account.new.save 


此 时 ， 我 们 可 以 使 用 define_callbacks 的 scope 参数 进行 解决 。 也 就 是 : 


define callbacks :save, scope: [:kind, :name] 


Rails © Callback 相关 的 模块 及 继承 关系 


ActiveRecord::Callbacks 
| 
V 
ActiveModel::Callbacks 


| 
V 


ActiveSupport::Callbacks 


ActiveModel::Validations::Callbacks 
ActiveJob::Callbacks 
ActionDispatch::Callbacks 
AbstractController::Callbacks 


| 
V 


ActiveSupport::Callbacks 


Filters 顺序 
一 条 "回调 链 " 上 可 以 有 多 个 "回调 "， 它 们 彼此 之 间 不 是 独立 的 ， 有 先后 顺序 。 即 : 
e Before，After，Around 


但 这 些 "回调 "也 有 终结 的 时 候 。 即 : 


define callbacks 定义 的 时 候 会 : 


define callbacks 

| 

V 
set callbacks name, CallbackChain.new(name, options) # 这 里 的 na 
me 表示 "回调 链 " 的 名 字 。 


def set callbacks(name, callbacks) # 这 里 的 callbacks 是 "回调 链 " 的 
实例 对 象 。 

send "_#{name}_callbacks=", callbacks 
end 


define callbacks 
| 
V 
def run Z(name) callbacks(&block) 
.run callbacks( £Z(name) callbacks, &block) 
end 


run callbacks 运行 的 时 候 会 : 


run callbacks 

| 

V 
run Z[kind) callbacks 4 这 里 的 kind 表示 " 某 种 类 型 的 "回调 链 

| 

V 
_run_callbacks(_#{name}_callbacks, &block) # 这 里 的 name 表示 "回调 
i 

| 

V 
runner = callbacks.compile # 这 里 的 callbacks 表示 "回调 链 " ; 

4 compile 会 创建 Callback 实例 对 象 并 做 后 

续 处 理 。 
e = Filters::Environment.new(self, false, nil, block) 
runner.call(e).value 


Callbacks 底层 简要 分 析 
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Configurable 


实例 方法 


config 用 @ config 实例 变量 来 保存 配置 信息 。 
使 用 举例 : 
require 'active support/configurable' 
class User 
include ActiveSupport::Configurable 
end 


user - User.new 


#5 config 对 象 


user.config.allowed access true 


user.config.level = 1 


# ix config WR 
user.config.allowed access # => true 
user.config.level # => 1 


类 方法 


config accessor 以 声明 的 形式 ， 同 时 定义 类 方法 和 实例 方法 。 实例 对 象 的 值 
默认 继承 于 类 对 象 ， 修 改 某 个 实例 对 象 的 值 不 影响 类 对 象 和 其 它 实例 对 象 的 值 。 


使 用 举例 : 


class User 
include ActiveSupport::Configurable 


# 直接 使 用 
config accessor :allowed access 
end 


# 相关 类 方法 

User.allowed access £ => nil 
User.allowed access - false 
User.allowed access £ -» false 


user - User.new 


# 相关 实例 方法 

user.allowed access # => false 
user.allowed access - true 
user.allowed access # => true 


User.allowed_access # => false 


再 次 举例 : 


class User 
include ActiveSupport::Configurable 


4 # instance reader instance writer 参数 

config accessor :allowed access, instance reader: false, insta 
nce writer: false 

4 带 instance accessor 参数 

config accessor :allowed access, instance accessor: false 


# # block 
config accessor :hair colors do 
[:brown, :black, :blonde, :red] 
end 
end 


Configurable 
除 此 之 外 ， 还 有 类 方法 : 


config # Configuration 的 实例 对 象 。 实 例 方法 config 和 类 方法 config a 
ccessor 调用 到 它 。 


configure # 直接 封装 config 


Note: 它 和 railties 目录 下 的 Configurable 和 Configuration 都 没有 关系 。 目 前 
RAMA AbstractController::Base 引用 到 它 (其 子 类 由 于 继承 关系 ， 也 可 以 使 
用 )。 


nel 


# 类 方法 
compile methods! 


# 实例 方法 
compile methods! 


另外 ， 它 继承 于 ActiveSupport::InheritableOptions 


Note: 不 对 module Configurable 之 外 提供 接口 ， 只 有 这 里 使 用 到 它 。 
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两 部 分 : Ordered Options 和 Ordered Hash. 


Ordered Options 
以 方法 的 形式 调用 Hash 的 key > i€ ^ 3 # value. 
普通 Hash : 

h = {} 


h[:boy] = 'John' 
h[:girl] - 'Mary' 


h[:boy] # => 'John 
h[ : girl] # => 'Mary' 


使 用 Ordered Options  : 


h - ActiveSupport: :OrderedOptions.new 


h.boy - 'John' 
h.girl = 'Mary' 


h.boy # => 'John' 
h.girl # => 'Mary' 


h[:boy] = 'John' 
h[:girl] - 'Mary' 


h[:boy] # => 'John' 
h[:girl] : 'Mary' 


Ordered Hash 


SG > Ruby 的 Hash 已 经 按照 加 入 时 的 顺序 进行 排序 ， 但 这 一 点 并 不 能 得 到 保 
证 ， 因 为 可 能 有 "猴子 补丁 "的 作用 。 


引入 此 模块 后 可 ， 至 少 可 当做 namespace， 解 决 这 一 问题 。 


oh = ActiveSupport::OrderedHash.new 
oh[:a] = 1 
oh[:b] = 2 


# 确保 key 的 顺序 和 加 入 时 一 样 
oh.keys 
# => [:a, :b] 


Inflector 
String 扩展 里 的 inflections 全 部 是 直接 封装 这 里 的 方法 而 来 。 
methods 


pluralize 
singularize 


camelize 
underscore 


humanize 
titleize 


tableize 
classify 


dasherize 
demodulize 
deconstantize 
foreign key 
constantize 

safe constantize 
ordinal 
ordinalize 


inflections 


parameterize 
transliterate 


transliterate 


transliterate 
parameterize 


inflections 


acronym 
clear 
human 
irregular 


plural 
singular 


uncountable 


Key Generator 和 Caching Key Generator 
相同 点 ， 都 提供 方法 : 


generate key 


不 同 点 : 


Key Generator 生成 的 是 初级 密 钥 。 


key generator = ActiveSupport::KeyGenerator.new 'secret' 
key generator.generate key 'salt' 


Caching Key Generator 再 次 封装 Key Generator 和 Thread Safe， 生 成 的 是 高 级 


RAA o 


key generator - ActiveSupport::KeyGenerator.new 'secret' 


y 日 ` 


参数 是 KeyGenerator Sb 9 
caching key generator = ActiveSupport::CachingKeyGenerator.new(k 
ey generator) 
caching key generator.generate key 'salt' 


an 


Note: i£ x fe [Message Encryptor 和 Message Verifier] #7 $55 ; 


两 部 分 : Message Verifier 和 Message Encryptor. 


Message Verifier 


生成 加 密 的 文本， 然后 用 于 校 验 。 这 里 的 加 密 仅 意味 着 "加 签名 、 防 莫 改 "， 过 程 是 
可 北 的 ， 请 注意 使 用 场景 。 使 用 场景 举例 ， 生 成 " 记 住 我 "的 token， 或 生成 "取消 订 
阅 "的 链接 。 


verifier = ActiveSupport::MessageVerifier.new('your-secret') 
message - "String that is prevented from tampering." 
2-5 (Jn 5 ) 


) 
17 
/ 


signed message - verifier.generate(message) 


verified - verifier.verify(signed message) 


Lb. zm 
Fa 


verified -- message 


# => true 


主要 是 generate(value) 和 verify(signed message) ， 原 理 很 简单 ， 这 里 
RS tik e 


A? WERE BREMER! 


verifier = ActiveSupport::MessageVerifier.new 's3Krit' 
signed message = verifier.generate 'a private message' 


verifier.valid message?(signed message) # => true 
tampered message = signed message.chop # KA" LEER" HIER 
verifier.valid_message?(tampered_message) # => false 


其 它 方法 : 


verified 


valid message? 


Message Encryptor 


和 Message Verifier 本 质 上 没有 区 别 。 但 使 用 上 会 更 严格 一 点 ， 会 多 一 些 步骤 (相应 
地 ， 也 更 安全 了 一 点 )， 并 且 它 也 有 调用 到 Message Verifier. 


还 有 一 个 优点 : Message Encryptor 生成 的 字符 串 会 比较 短 ， 比 Message Verifier 
生成 的 更 适合 直接 放 到 url 里 。 


使 用 举例 : 


salt = SecureRandom.random bytes(64) 
secret key base - '-- secret key base --' 


key generator - ActiveSupport::KeyGenerator.new(secret key base) 
key = key generator.generate key(salt) 


encryptori = ActiveSupport::MessageEncryptor.new(key) 
encryptor2 = ActiveSupport::MessageEncryptor.new(key) 


message = "Encrypted string." 
encrypted message = encryptori.encrypt and sign(message) 


decrypted - encryptor2.decrypt and verify(encrypted message) 


decrypted -- message 


i € encrypt and sign(value) 和 decrypt and verify(value) ， 同 样 
RETZA © 


Message Encryptor ` Message Verifier 和 Key Generator 这 三 者 使 用 类 似 ， 创 建 时 
可 传递 字符 串 做 为 参数 ， 然 后 进行 加 密 ， 生 成 的 也 是 字符 串 。 


实例 参考 
salt = SecureRandom.random bytes(64) # 保存 进 数 据 库 
secret key base = '-- secret base --' # 保存 到 配置 文件 
string - 'string' # 运行 于 代码 
secret = Digest::MD5.hexdigest("#{secret_key_base}-#{string}") 
key = ActiveSupport::KeyGenerator.new(secret).generate_key(sa 
it) 


crypti = ActiveSupport::MessageEncryptor.new(key) 


string = 'string' # 运行 于 代码 

secret = Digest::MD5.hexdigest("#{secret_key_base}-#{string}") 
key = ActiveSupport::KeyGenerator.new(secret).generate_key(sa 
lt) 


crypt2 = ActiveSupport::MessageEncryptor.new(key) 


source_data = 'my secret data' H 加 密 前 数据 
encrypted data = crypti.encrypt and sign(source data) # 加 窖 后 数据 
decode data - crypt2.decrypt and verify(encrypted data) 
source data -- decode data 


Note: 注意 和 【Key Generator 和 Caching Key Generator] 3€ Y 4K A © 


String Inquirer - Rails.env.production? 
原来 的 代码 : 

Rails env == "production: 
语法 糖 : 

Rails.env.production? 


仅 作 用 于 Rails.env 对 象 ， 方 法 是 动态 生成 的 ， 所 以 API 里 查询 不 到 。 


手法 : 把 方法 最 后 的 问号 去 掉 ， 看 是 否 和 当前 环境 一 样 。 


Array Inquirer 


元 素 后 面 加 ? ， 可 直接 查询 是 否 在 数组 内 : 
variants = ActiveSupport::ArrayInquirer.new([:phone, 
variants.phone? # => true 
variants.tablet? # => true 
variants.desktop? # => false 

使 用 any? 查询 元 素 是 否 在 数组 内 
variants = ActiveSupport::ArrayInquirer.new([:phone, 
variants.any? # => true 
variants.any?(:phone, :tablet) # => true 
variants.any?('phone', 'desktop') # => true 
variants.any?(:desktop, :watch) # => false 


: tablet]) 


: tablet]) 


Tagged Logging 
封装 了 Ruby 标准 的 Logger > iE 441 48% 4% logger 实例 对 象 打 "标签 "。 
logger = ActiveSupport::TaggedLogging.new(Logger.new(STDOUT)) 


logger.tagged('BCX') ( logger.info 'Stuff' ) 
4 -» Logs "[BCX] Stuff" 


"标签 "还 可 以 层 层 县 加 : 


logger.tagged('BCX', "Jason") ( logger.info 'Stuff' } 
# Logs. (BCX) [Jason | StU 


logger.tagged('BCX') ( logger.tagged('Jason') { logger.info 'Stu 
me) hy 


# Logs "[BCX] [Jason] Stuff" 
Rails.logger 默认 已 经 使 用 。 


实现 : 封装 了 Logger VFM IR RST EA #6 Formatter 对 象 ， 并 添加 了 
tagged 方法 。 


Gzip 5 JSON 


Gzip 
封装 了 标准 库 zlib > 4 gzip 压缩 /解压 缩 字符 串 功 能 。 


# 压缩 
gzip = ActiveSupport::Gzip.compress('compress me!') 
4 => "\x1F\x8B\b\x000\x8D\.. . NXB3NÉNXOONXOONXOO" 


# 解压 缩 
ActiveSupport::Gzip.decompress(gzip) 
# => "Compress me!" 


JSON 
提供 json 格式 的 编码 /解码 。 


encode(value, options = nil) 将 对 象 转换 成 JSON 格式 
# Ao 
# 是 模块 方法 


ActiveSupport::JSON.encode(( team: 'rails', players: '36' }) 
poc sam E N Palle. players Se A E 


decode(json, options = {}) 将 JSON 字符 串 转换 成 Hash 


ray 
es 


|o 
Neo xm 


# 
# 是 类 方法 

ActiveSupport: : JSON.decode("{\"team\":\"rails\",\"players\":\"36 
ILLUM 


=> {team => “rails”, "players == 7305 


Backtrace Cleaner 


报错 或 程序 运行 反馈 信息 过 多 、 过 杂 ， 找 不 到 关键 点 ?你 可 以 使 用 Backtrace 


+1) 创建 对 外 


bc = BacktraceCleaner.new 


Mi Y A ha ml ay 16 > 1 421% H pee b> Be 
# 2) AJ ALI] | 4g | Bar! s Fir RAS E: 
1 4, ISA] AB ] 4 jor de as 


bc.add filter ( |line| line.gsub(Rails.root, '') } 
# 2) 添加 规则 。 可 指定 "删除 ' 某 gem 信息 : 


bc.add silencer { |line| line =~ /mongrel|rubygems/ } 


LL \ th 324 cm ll ayrant; ha Fr A Witsoe RASA mE 
# 3) WITIR ° M exception.backtrace EN 7& 43 eal yy Fi P 


bc.clean(exception.backtrace) # 


除 以 上 例子 使 用 到 的 方法 外 ， 还 有 : 


方法 


filter & clean 执行 过 滤 。 参 数 是 要 处 理 的 信息 


remove filters! 移 除 之 前 的 ' 替 换 ' 规 则 
remove silencers! 移 除 之 前 的 ' 删 除 ' 规 则 


合 Rails 使 用 
Rails 启动 时 就 已 使 用 backtrace cleaner, 并 且 抛 异常 时 会 对 弄 常 消息 进行 过 滤 。 


也 就 是 说 ，Rails 已 经 帮 我 们 做 了 第 1 和 第 3 步 ， 我 们 只 要 做 第 2 步 "添加 规则 " 即 
To 可 以 在 以 下 配置 文件 ， 设 置 过 滤 条 件 : 


F config/initializers/backtrace-silencers.rb 
Rails.backtrace cleaner.add silencer ( |line| line -- /my noisy. 
library/ ) 


通过 以 下 方式 ， 可 以 查看 backtrace_cleaner 的 filters 和 silencers 信息 : 


Rails.backtrace cleaner 

=> #<Rails: :BacktraceCleaner :0x007ff859bed328 

Qfilters- 
[4«Proc:0x007ff859bed238Q/Users/.../lib/rails/backtrace cleane 

r.rb:10>, 
#<Pr0c:0x007ff859bed210@/Users/.../lib/rails/backtrace_cleane 

r.rb211>, 
H«Proc:0x007ff859bedi1cO0Q/Users/.../lib/rails/backtrace cleane 

conb: 1227 
H«Proc:0x007ff859bec450Q/Users/.../lib/rails/backtrace cleane 

r.rb:26>], 

Qsilencers- 
[4«Proc:0x007ff859bec428Q/Users/.../lib/rails/backtrace cleane 

r.rb:15>]> 


Ht (Rails 里 的 backtrace_cleaner 的 定义 与 调用 ) : 


定义 : 


Backtrace Cleaner 


4 railties/lib/rails/backtrace cleaner.rb 
module Rails 
class BacktraceCleaner « ActiveSupport::BacktraceCleaner 


4 railties/lib/rails.rb 

def backtrace cleaner 
Qbacktrace cleaner ||= begin 
require 'rails/backtrace cleaner' 
Rails::BacktraceCleaner.new 
end 

end 


4 railties/lib/application.rb 
def env config 
Ho... 
"action dispatch.backtrace cleaner" -» Rails.backtrace cleaner 


调用 : 


4 action dispatch/middleware/exception wrapper.rb 
def backtrace cleaner 
Qbacktrace cleaner ||= Qenv['action dispatch.backtrace cleaner' 


] 


end 


def clean backtrace(*args) 
if backtrace cleaner 
backtrace cleaner.clean(backtrace, *args) 
else 
backtrace 
end 
end 


Hm————— RÀ ' | 
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Backtrace Cleaner 
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Number Helper 


number to currency 


number to delimited 


number to human 


number to human size 


number to percentage 


number to phone 


number to rounded 


autoload 
autoload 
autoload 
autoload 
autoload 
autoload 
autoload 


autoload 


:NumberToRoundedConverter 
:NumberToDelimitedConverter 
:NumberToHumanConverter 
:NumberToHumanSizeConverter 
:NumberToPhoneConverter 
:NumberToCurrencyConverter 
:NumberToPercentageConverter 


| 
V 


:NumberConverter 


Benchmarkable 


耗 时 统计 


执行 某 程 序 ， 用 了 多 少时 间 ? 


benchmark 


使 用 举例 : 


<% benchmark 'Process data files', level: :info, silence: true do 
%> 

<%= expensive_and_chatty_files_operation %> 
<% end %> 


ss = 
TAA gem 'newrelic' 等 大 致 定 位 ， 然 后 使 用 benchmark 实现 精确 定位 。 


链接 标准 库 Benchmark 


Xml Mini 


Xml Mini 属于 接口 ， to xml 底层 处 理 之 一 ， 以 及 允许 你 切换 使 用 不 同 的 库 进 行 
解析 HTML/XML. 


默认 用 的 是 标准 库 REXML， 不 过 你 可 以 使 用 性 能 更 快 的 LibXML 或 Nokogiri. (性 
能 上 快 得 多 ， 不 过 有 极 少 数 不 规范 的 网 站 可 能 会 解析 失败 ) 


ActiveSupport::XmlMini.backend 


# => ActiveSupport::XmlMini REXML 


类 方法 (对 外 接口 ) : 


backend 
backend= 


rename key 
to tag 


with backend 


此 外 ， 还 有 类 方法 : 


delegate :parse, :to => :backend 


parse 是 主要 对 外 接口 。 前 台 保 持 它 不 变 即 可 ， 后 台 可 随意 更 改 解析 器 。 


可 选择 的 库 : 


XmlMini JDOM 
XmlMini LibXML 
XmlMini LibXMLSAX 
XmlMini Nokogiri 
XmlMini NokogiriSAX 
# 这 是 默认 的 


XmlMini REXML 


使 用 示例 : 


gem 'libxml-ruby', '=0.9.7' 
XmlMini.backend = 'LibXML' 


A > Rails 里 的 数组 和 哈 希 的 to xml 也 用 到 了 它 进 行 转换 处 理 。 


Multibyte 


使 处 理 各 种 字符 成 为 可 能 。 
类 方法 : 
proxy class 


proxy class- 


ActiveSupport::Multibyte.proxy class = CharsForUTF32 


Chars 
Rails 里 很 多 字符 串 ， 都 会 先 转换 成 它 的 实例 对 象 ， 然 后 再 处 理 。 


实例 方法 : 


capitalize 

compose 

decompose 

downcase 

grapheme length 
limit 

normalize 
respond to missing? 
reverse 

Slice! 

split 

swapcase 

tidy_bytes 

titleize & titlecase 


upcase 


通 字符 串 
方 


= 
里 的 实例 


2 
Te 


通过 mb chars 方法 ， 可 以 得 到 Chars 的 实例 对 象 ， 然 后 可 以 调用 这 
法 。 


Multibyte 


require 'active support/multibyte' 


class String 
def mb chars 
ActiveSupport::Multibyte.proxy class.new(self) 
end 
end 


"The Perfect String '.mb chars.downcase.strip.normalize # => "t 
he perfect string" 


Note: Chars 还 封装 使 用 了 下 面 的 Unicode. 


Unicode 


RAH: 


803 


compose 


decompose 


downcase 


in char class? 


normalize 


pack graphemes 


reorder characters 


swapcase 


tidy bytes 


unpack graphemes 


upcase 


指定 Rails 里 准备 过 期 的 方法 、 实 例 变量 、 对 象 和 常量 。 


include Singleton 

include InstanceDelegator 
include Behavior 

include Reporting 

include Methodwrapper 


具体 不 做 介绍 。 


Active Support 核心 扩展 


TODO 


Array 


Access 


from 
to 


without 
second 
third 
fourth 


fifth 
forty_two 


Conversions 


to_sentence 
to_formatted_s & to_default_s & to_s 


to xml 


Extract options 


extract options! 


Grouping 


in groups 
in groups of 


split 


prepend and append 


append & «« 
prepend & unshift 


Wrap 


wrap 


Array Inquirer 

数组 可 以 调用 期 望 所 包含 元 素 结尾 加 ? 以 询问 是 否 包含 此 元 素 。 
或 使 用 any? 传递 元 素 名 字 询 问 。 
其 它 

inquiry 

deep_dup 


to_param 
to_query 


Benchmark 


ms 


使 用 举例 : 


Benchmark.realtime { User.all ) 
# => 8.0e-05 

4 和 realtime 一 样 ， 但 单位 是 "毫秒 " 
Benchmark.ms { User.all } 

# => 0.074 


Big Decimal 


duplicable? 


Class 


class attribute 


subclasses 


Date 


«-» & compare without coercion & compare with coercion 
acts like date? 

blank? 

advance 


ago 
since & in 


at beginning of day & beginning of day & midnight & at midnight 
at end of day & end of day 

midday & noon & at midday & at noon & middle of day 
at middle of day 

beginning of week 

beginning of week- 

change 

current 

find beginning of week! 

inspect 

default inspect 

readable inspect 

to default s 

to formatted s 


to s 


to time 
tomorrow 


xmlschema 
yesterday 


plus with duration & + & plus with duration 


minus without duration & - & minus with duration 


Time 


acts like time? 


minus with coercion 
minus without coercion 
minus without duration 
<=> 
compare_with_coercion 
compare_without_coercion 


acts_like_time? 

advance, ago, all_day, 

at_beginning_of_day 

beginning_of_day 

at_midnight 

midnight 

at_beginning_of_hour & beginning_of_hour 
at_beginning_of_minute & beginning_of_minute 


at_end_of_day & end_of_day 


at_end_of_hour 
end_of_hour 


at_end_of_minute 
end_of_minute 


at_midday 


midday 

at middle of day 
middle of day 

at noon 

noon 

at with coercion 
change 

current 
days. in month 
eql? 
eql_with_coercion 
eql_without_coercion 


find zone, find zone!, formatted offset 


in 
since 


seconds since midnight, seconds until end of day 


days in year 


to default s & to formatted s & to s 


formatted offset 


zone 
zone- 


use zone 


find zone 
find zone! 


Date Time 


<=> 


acts like date? 
acts like time? 


at beginning of day 
beginning of day 


at beginning of hour 
beginning of hour 


at beginning of minute 
beginning of minute 


at end of day 
end of day 


at end of hour 
end of hour 


at end of minute 
end of minute 


at midday 
middle of day 
noon 

at middle of day 


advance, ago, 

at midnight, at noon 

change, civil from format, current 
formatted offset 


in 
since 


inspect 
default inspect 


midday, midnight 


readable inspect 
seconds since midnight, seconds until end of day 


to f 
to i 


to s 
to default s 


to formatted s 


nsec 
usec 


utc 
getutc 


utc? 


utc offset 


on weekend? 


next weekday 
prev weekday 


Duration 
fe Date ` Time ` DateTime ` TimeWithZone 等 时 间 相 关 类 的 关系 比较 深 。 
ago & until 


from now & since 


使 用 举例 : 


1.month.ago # 等 价 于 Time.now.advance(months: -1) 


Time With Zone 


X44 Ruby A 249 Time > 42 Ruby A E 8) Time 所 创建 的 实例 对 象 局 限于 UTC 和 
系统 的 ENV[TZ] 时 区 。 这 里 的 实例 没有 此 局 限 ， 你 可 以 用 你 想 用 的 时 区 。 


你 不 能 直接 使 用 new 创建 TimeWithZone 实例 对 象 ， 但 可 以 用 local, parse, at 和 
now 创建 TimeZone 实例 对 象 ， 或 者 in_time zone 创建 Time 和 DateTime 
实例 对 象 。 


Time.zone = 'Eastern Time (US & Canada)' 
# => 'Eastern Time (US & Canada)' 


Time.zone.local(2007, 2, 10, 15, 30, 45) 
# => Sat, 10 Feb 2007 15:30:45 EST -05:00 


Time.zone.parse('2007-02-10 15:30:45') 
# => Sat, 10 Feb 2007 15:30:45 EST -05:00 


Time.zone.at(1170361845) 
# => Sat, 10 Feb 2007 15:30:45 EST -05:00 


Time.zone.now 
# => Sun, 18 May 2008 13:07:55 EDT -04:00 


Time.utc(2007, 2, 10, 20, 30, 45).in_time_zone 
# => Sat, 10 Feb 2007 15:30:45 EST -05:00 
查询 Time fr TimeZone 的 API 可 以 对 这 些 方法 有 更 多 的 了 解 。 


TimeWithZone 创建 的 实例 对 象 和 Ruby 内 置 的 Time 创建 的 实例 对 象 完全 兼容 ， 也 
就 是 说 它们 是 等 价 关 系 。 


t= 
:25 EDT -04:00 
.hour 
.dst? 
.utc offset 


dk dt + Gt # 


.to_s(:rfc822) 


2215 


t 
t 
t 
t.zone 
t 
iG -0400" 
t 


+ 1.day # = 


:25 EDT -04:00 
t.beginning_of_year E 
:00 EST -05:00 


t » Time.utc(1999) # = 


# 完全 兼容 ， 它 们 是 等 价 关系 。 


t.is a?(Time) & 


t.is_a?(ActiveSupport: :TimewithZone) # = 


Time.zone.now uz: ES 


SUM, 


3 
true 


18 May 2008 13:27 


-14400 


"EDT" 
Sun 


Mon, 


Tue, 


true 


true 
true 


18 May 2008 13:2 


19 May 2008 13:27 


01 Jan 2003 00:00 


相关 : Date, Time, DateTime, DateAndTime 以 及 TimeZone. 


实例 方法 : 


acts like time?, advance, ago, as json 
between?, blank? 
comparable time 
dst? 

eql? 

formatted offset, 


freeze, future? 


getgm, getlocal, getutc, gmt?, gmt offset, gmtime, gmtoff 


hash, httpdate 


in time zone, inspect, is a?, isdst, iso8601 


kind of? 


localtime 


marshal dump, marshal load, method missing 


name 


past?, period 


respond to?, respond to missing?, rfc2822, rfc822 


since, strftime 


time 


to a, to datetime, to f, to formatted s, to i, to r, to s, to ti 
me 


today?, tv sec 


utc, utc?, utc offset 


xmlschema 


zone 


Time Zone 

类 方法 : 
[] 
all 
create & new 
find_tzinfo 
seconds_to_utc_offset 
us_zones 


zones_map 


实例 方法 : 


at 


formatted offset 


local 
local to utc 


now 


parse 


period for local 
period for utc 


to s 
today 
tomorrow 
next day 
yesterday 
prev. day 


utc offset 


utc to local 


Enumerable 


exclude? 
many? 


index by 
sum 


File 


atomic write 


Hash 
实例 方法 : 
assert valid keys 


compact 
compact ! 


deep. dup 
deep merge 


deep merge! 


deep stringify keys 
deep stringify keys! 


deep symbolize keys 
deep symbolize keys! 


deep transform keys 
deep transform keys! 


except 
except ! 


extract! 
extractable options? 


nested under indifferent access 
with indifferent access 


reverse merge 
reverse merge! & reverse update 


slice 
slice! 


stringify keys 
stringify keys! 


symbolize keys & to options 
symbolize keys! & to options! 


to param 
to query 


to xml 


transform keys 
transform keys! 


类 方法 : 


from trusted xml 
from xml 


Hash With Indifferent Access 

4: 3€ Hash 时 ， 使 得 :foo 和 "foo" 所 代表 的 意思 是 一 样 的 。 
rgb = ActiveSupport: :HashwithIndifferentAccess.new 
rgb[:black] = '#000000' 


rgb[: black] 
rgb[ > black' ] ZI => ! 





rgb['white'] = '#FFFFFF' 
rgb[:white] # => '#FFFFFF' 
rgb['white'] # => '#FFFFFF 
[] 

[]= 

regular_writer 


store 


convert_key 
convert value 


deep stringify keys 
deep stringify keys! 


deep symbolize keys 


default 


delete 


dup 


extractable options? 


fetch 


has key? 
key? 

include? 
member? 


merge 
update 
regular update 
merge! 


nested under indifferent access 
new 
new from hash copying default 





reject 
replace 


reverse merge 
reverse merge! 


select 


stringify keys 
stringify keys! 


symbolize keys 


to hash 
to options! 


values at 
with indifferent access 


Integer 


month & months 
year & years 


multiple of? 


ordinal 
ordinalize 


Numeric 


byte & bytes 

day & days 
duplicable? 

exabyte & exabytes 
fortnight & fortnights 
from now 

gigabyte & gigabytes 
hour & hours 

html safe? 

in milliseconds 
kilobyte & kilobytes 
megabyte & megabytes 
minute & minutes 
petabyte & petabytes 
second & seconds 
terabyte & terabytes 
to formatted s 


week & weeks 


Numeric 


834 


Kernel 


breakpoint & debugger 
capture & silence 
class eval 

concern 

enable warnings 
quietly 


silence stream 
silence warnings 


suppress 


with warnings 


Object 


acts like? 

blank? 

create fixtures 

deep. dup 

duplicable? 

html safe? 

in? 

instance values 
instance variable names 


presence 
presence in 


present? 


to json with active support encoder 





to param 
to query 


try 
try! 


unescape 


with options 


Object 


837 


Module 


alias attribute 
alias method chain 


anonymous?, 


attr internal 
attr internal accessor 


attr internal reader 
attr internal writer 


cattr accessor 
mattr accessor 


cattr reader 
mattr reader 


cattr writer 
mattr writer 


delegate 

deprecate 

foo 

parent 

parents 

parent name 
qualified const defined? 
qualified const get 
qualified const set 


redefine method 


remove possible method 


Module 


840 


alias method chain 
不 修改 原 有 接口 和 调用 代码 ， 给 接口 添加 额外 的 行为 。 


举例 : 


# KA 

1 class Klass 

2 def salute 
3 puts "Aloha!" 

4 # do some other things... 
5 end 

6 end 

7 

8 Klass.new.salute 

9 


# => Aloha! 
10 # do some other things... 


KERK TAERA JEDE ARREA o eH CS AG AARA A RE 
录 。 他 想到 了 一 个 方法 : 


puts "Before do salute ..." 
Klass.new.salute # => Aloha! 
puts "End do salute ..." 


四 觉得 这 么 做 非常 好 ， 于 是 大 力 推荐 别人 也 这 么 做 ， 其 中 就 包括 王 五 。 但 王 五 觉 
李 四 疯 了 ， 因 为 这 意味 着 要 修改 已 有 代码 ， 并 且 很 匡 陋 。 


dà od 


李 四 想 了 想 ， 于 是 这 么 做 .… 


# 代码 二 

1 class Klass 

2 def salute with log 

3 puts "Before do salute ..." 

4 salute_without_log 

5 puts "... End do salute" 

6 end 

7 

8 alias_method :salute_without_log, :salute 
9 alias method :salute, :salute with log 
10 end 


它 利 用 "猴子 补丁 "并 且 两 次 使 用 alias method 以 达到 效果 ， 检 验 一 下 : 


Klass.new.salute # -> 调用 代码 一 ， 第 2 47: 
# 但 代码 二 ， 第 9 行 更 改 了 调用 ; 
# 实际 运行 的 是 代码 二 ， 第 2 行 。 


# 输出 : 
Before do salute ... # -> 对 应 代码 二 ， 第 3 行 


3 


# 接 下 来 运行 代码 二 ， 第 4 行 ; 但 代码 二 ， 第 8 行 更 改 了 调用 ; 实际 运行 的 是 代 丰 
人 2s 


# 输出 
Aloha! 


# 接 下 来 运行 代码 二 ， 第 51 


# 输出 
End do salute 


完美 ， 既 没有 修改 张 三 的 接口 ， 也 没有 修改 王 五 的 调用 代码 。 
只 要 张 三 提 供 的 接口 不 变 ， 王 五 的 调用 代码 就 不 用 修改 ， 而 自己 的 代码 也 能 顺利 运 


o 


— N 


但 上 面 隐藏 着 一 个 很 大 的 问题 : 代码 二 ， 第 8、9 行 顺序 不 能 颠倒 ， 一 不 小 心 的 
话 ， 将 进入 死 循环 里 去 ... 


Calling method... 
Calling method... 
Calling method... 
SystemStackError: stack level too deep 


使 用 alias method chain 可 以 防 患 于 未 然 ， 不 必 再 担忧 : 


class Klass 


def salute 
puts "Aloha!" 
end 
end 


Klass.new.salute 
# => Aloha! 


class Klass 
def salute_with_log 
puts "Begin do salute ..." 
salute_without_log 
puts "... End do salute" 
end 
alias method chain :salute, :log 


end 


Klass.new.salute 


# => 

# Begin do salute 

# Aloha! 

4 ... End do salute 


Rails 5 € alias method chain 已 被 移 除 ， 因 为 Ruby 自 带 prepend 可 
以 使 用 。 


Marshal 


load with autoloading 


Range 


overlaps? 
include with range? 


to s 
to default s 
to formatted s 


Regexp 


multiline? 


Secure Random 


uuid v3 
uuid v5 


uuid from hash 


String 


acts like string? 
at 

blank? 
camelcase 
camelize 
classify 
constantize 
dasherize 
deconstantize 
demodulize 
exclude? 
first 

foreign key 
from 

html safe 
humanize 

in time zone 


indent 
indent! 


inquiry 


is utf8? 


last 


mb chars 


parameterize 


pluralize 


remove 
remove! 


safe constantize 


singularize 


squish 
squish! 


strip heredoc 
tableize 
titlecase 
titleize 

to 

to date 

to datetime 


to time 


truncate 
truncate words 


underscore 


String 


850 


URI 


parser 


Load Error 


is missing? 


path 


Name Error 


missing name 
missing name? 


Logger 


扩展 标准 库 Logger 


Logger Silence 


提供 Logger 的 实例 方法 : 


silence 


使 用 举例 : 


Rails.logger.silence do 


"Au m Em tr ıh 44h og 
TE Yale FI AH] ih H E 


H ix W od 
F ... CES THUS 


end 


可 以 通过 以 下 设置 ， 不 用 此 特性 : 
ActiveSupport::Logger.silencer = false 
此 时 ，silence 所 包含 的 block 里 的 "程序 所 输出 的 日 志 " 不 会 被 清除 。 


链接 


标准 库 Logger 


Active Support 其 它 类 和 模块 
比如 : 


Per-Fhread-Registry 


Security Utils 


secure compare 


a string == b string 当 发 现 两 字符 串 有 字符 不 一 致 时 ， 就 会 立即 返回 比较 结 
果 。 


在 这 样 的 机 制 下 , 比较 时 间 与 字符 串 匹配 度 是 有 正比 关系 的 , 字符 串 匹配 度 越 高 ， 比 
较 时 间 越 长 。 因 此 ， 便 有 可 能 通过 对 比 时 间 差 的 方式 逐一 猜测 破解 (计时 攻击 ) > 


使 用 此 方法 ? 即使 发 现 两 字符 串 有 不 同 $ 也 不 会 立即 返回 结果 r 而 是 继续 比较 下 
去 ， 确 保 比 较 时 间 是 一 样 的 ， 可 预防 计时 攻击 。 


MessageVerifier 在 校 验 信息 的 时 候 就 用 到 了 它 。 
HttpAuthentication Basic 认证 的 时 候 就 用 到 了 它 。 
RequestForgeryProtection 在 比较 token 的 时 候 也 用 到 了 它 。 


参考 


计时 攻击 原理 以 及 Rails 对 应 的 防范 


railties 


结构 

1) Railtie 

对 Rails 本 身 的 改造 。 

2) Engine 

xt Rails 外 围 的 扩展 。 

3) Application 

初始 化 时 : Bootstrap 在 前 ，Finisher 在 后 。 
与 我 们 应 用 接头 。 


实例 方法 ， 给 Rails.application 使 用 。 


1) 配置 
指 的 是 Railtie, Engine, Application 的 Configuration. 
2) 初始 化 


"初始 化 "这 里 是 名 词 ， 主 要 是 对 它 的 使 用 ， 如 Application 的 Bootstrap 和 
Finisher ， 以 及 我 们 项 目 AppName 所 涉及 到 的 初始 化 。 


3) 启动 ! 
没有 额外 的 "启动 "程序 ， 把 配置 、 初 始 化 做 好 了 以 后 ， 启 动 就 是 自然 而 然 的 事 了 。 
4) 功能 扩展 


通过 Railtie ^ Engine 实现 ， 特 别 是 Engine 可 以 大 大 方便 我 们 组 织 代码 。 


继承 关系 


Rails.application.class.ancestors 


=> [AppName::Application, 


Rails: 
Rails: 
Rails: 
Rails: 
Object, 


Kernel, 


:Application, 
:Engine, 
:Railtie, 
:Initializable, 


BasicObject] 


Railtie 
Railtie 是 Rails 的 核心 部 分 之 一 。 通 过 它 ， 可 以 扩展 和 修改 Rails 的 初始 化 程序 。 
什么 时 候 需 要 使 用 Railtie? 当 你 的 扩展 符合 下 列 情况 时 ， 可 以 考虑 : 


e 替换 默认 组 件 
e Rails 启动 时 即 要 配置 内 容 
e Rails 启动 时 即 要 初始 化 内 容 


每 一 个 Rails 组 件 (如 : ActionMailer, ActionController, ActionView 和 ActiveRecord 
等 ) 都 属于 Railtie. 因为 它们 都 需要 自己 的 初始 化 程序 。 


Railtie 只 是 配置 及 初始 化 文件 


Railtie 不 属于 站 正 意义 上 的 ”代码 ”， 代 码 已 经 完成 。 想 把 它 运 用 到 Rails 项 目 里 ， 
并 且 扩 展 或 修改 Rails 的 配置 、 初 始 化 过 程 ， 才 需要 引进 Railtie. 


一 个 gem 是 Raitie， 通 常 是 指 它 有 raitie.rb (再 准确 点 ， 有 类 继承 于 Rails::Railtie) 
.. 并 不 影响 它 的 其 它 代码 。 


通常 你 的 项 目 jas al ' raitie.rb 只 是 针对 Rails 项 目 初始 化 或 配置 工作 ， 
不 推荐 把 项 目 代码 放 到 这 里 。 


Engine # Application 

Engine X Railtie 的 子 类 ， 所 以 Railtie 里 的 方法 ， 由 于 继承 关系 ， 它 也 可 以 使 用 。 
Application 是 Engine 的 子 类 ， 所 以 Railtie 里 的 方法 ， 由 于 继承 关系 ， 它 也 可 以 使 
用 o 

查看 本 项 目下 ， 所 有 的 Railtie : 


Rails.application.send(:ordered railties) 


Rails 启动 是 一 个 复杂 的 过 程 ， 你 不 必 知 道具 体 在 哪 一 步 执行 Railtie 代码 。 


Railtie 


861 


Railtie 文件 下 的 内 容 
提供 以 下 实例 方法 : 
initializer 


实际 上 initializer X X T Rails:initializable. 它 还 可 以 接受 :before 或 :after 
做 为 参数 。 


Rails::Railtie include 了 它 ， 所 以 对 外 提供 有 initializer 方法 : 


class MyRailtie < Rails::Railtie 
# initializer 来 源 于 Rails::initializable 
initializer "my railtie.configure rails initialization" do 
# 一 些 初始 化 代码 
end 
end 


initializer 还 可 将 应 用 做 为 参数 ， 所 以 可 以 这 么 用 : 


class MyRailtie < Rails::Railtie 
initializer "my railtie.configure rails initialization" do |ap 
pl 
app.middleware.use MyRailtie::Middleware 
end 
end 


config 


你 可 以 使 用 config 对 象 ， 它 在 所 有 Railtie 和 你 的 应 用 里 是 共用 的 。 


class MyRailtie « Rails::Railtie 
# 配置 使 用 什么 ORM 
config.app generators.orm :my railtie orm 


# to prepare 里 的 内 容 在 生产 环境 上 只 执行 一 次 ， 在 开发 环境 下 每 个 请 求 都 会 请 
求 一 人 遍 。 
config.to prepare do 
MyRailtie.setup! 
end 
end 


Note: config 定义 于 Configurable. delegate :config, to: :instance 


rake tasks & generators 


继承 于 Rails: Railtie 所 以 有 rake_tasks 方法 : 


class MyRailtie < Rails::Railtie 
rake tasks do 
load "path/to/my railtie.tasks" 
end 
end 


继承 于 Rails::Railtie 所 以 有 generators 方法 : 


class MyRailtie < Rails::Railtie 
generators do 
require "path/to/my railtie generator" 
end 


类 方法 : 


# 动词 ， 接 block 
rake tasks 
console 

runner 
generators 


configure # 动词 


railtie name 


instance 
subclasses 


abstract railtie? # 默认 是 Rails::Railtie^Rails::Engine 和 Rails: 
‘Application 


实例 方法 : 


config # 名 词 
configure 
railtie namespace 


部 分 方法 的 解释 ， 可 以 参考 已 有 解释 的 方法 ， 或 参考 Engine 里 的 方法 。 


Initializable 


18 #9 Xt Rails::Initializable. 


本 模块 被 Railtie 775] A > Ra TARA * Engine ^ Application ^ AppName 都 可 
用 里 面 的 方法 。 
ie: 自 定义 的 Railtie 及 其 子 类 里 常用 到 的 initializer 方法 ， 就 是 它 定 义 的 。 


类 方法 : 
initializer 
initializers for 


initializers 
initializers chain 


JP initializer 负责 创建 initializer， 并 加 入 initializers. 


可 用 initializers for 获取 应 用 里 茶 类 initializer 的 名 字 : 
Rails.app class.initializers for('"web console").map &:name 
实例 方法 : 
initializers 
run initializers 
可 用 initializers 获取 应 用 里 所 有 的 initializer 的 名 字 : 


Rails.application.initializers.map &:name 


Initializer 


所 谓 的 "初始 化 "， 即便 它 是 一 个 行为 ， 也 要 结构 化 ， 在 Rails 里 用 Initializer 表示 。 


每 一 个 "初始 化 "操作 ， 都 对 应 其 一 个 实例 对 象 。 


Configuration 


Railtie » Engine ` Application 都 有 自己 的 Configuration 模块 。 


由 于 Ruby 的 继承 机 制 ， 我 们 常用 的 config 可 以 看 作 是 它们 中 任意 一 个 的 实例 
对 象 。 所 以 ， 理 论 上 来 说 ， 它 们 提供 的 接口 config 都 可 直接 调用 。 


对 外 提供 接口 


app_generators 
app middleware 


eager load namespaces 


to prepare 
to prepare blocks 


watchable dirs 
watchable files 


before eager load 
before configuration 


after initialize 
before initialize 


另 ， 自 定义 的 Railtie 和 自 定义 的 Engine， 也 可 以 对 外 提供 config 接口 。 


定制 自己 的 Railtie 


一 ， 继 承 于 Rails::Railtie 
继承 于 Rails::Railtie ， 即 可 创建 自己 的 Railtie. 在 Rails 启动 的 时 候 ， 它 也 会 被 执 
行 。 
举例 : 
4 lib/my gem/railtie.rb 
module MyGem 
class Railtie « Rails::Railtie 


end 
end 


# lib/my gem.rb 
require 'my gem/railtie' if defined?(Rails) 


创建 Railtie， 除 了 lib/my_gem/railtie.rb 里 继承 于 Rails::Railtie 外 ， 你 不 需要 更 改 
其 它 地 方 的 代码 。 并 不 影响 my. gem 原来 要 做 的 事 ， 也 正如 此 ，my_gem 也 可 以 
在 Rails 之 外 使 用 。 


二 ， 编 写 自 己 的 my railtie/railtie.rb 文件 内 容 
可 用 Rails::Railtie 提供 的 方法 。 


— * 编写 Railtie 内 容 


做 了 上 述 两 步 后 ， 就 是 编写 内 容 。 该 做 什么 事 ， 做 什么 事 ; 该 完成 什么 功能 ， 完 成 
什么 功能 。 


四 ， 在 应 用 启动 时 自动 调用 定制 的 Railtie 


自动 运行 my_railtie/railtie.rb 里 面 的 相关 启动 代码 。 


Railtie 补充 


TODO 


Rails 默认 组 件 都 是 Railtie 


Action Mailer 


初始 化 : 


logger 
set configs 
compile config methods 


show previews 


Abstract Controller 
引入 Route 相关 的 helper( 这 里 只 是 调用 ， 定 义 在 RouteSet €) 。 


routes.rb 里 定义 的 每 一 个 路 由 规则 都 会 有 对 应 的 x url fe x path 等 helper 方 
法 可 用 ， 这 里 include 了 这 些 helper. 


然后 ，Action Controller 和 Action Mailer 的 Railtie 又 extend Routes Helpers， 所 
以 可 用 。 


Note: 可 以 通过 include Rails.application.routes.url helpers 然后 
调用 和 Routing 相关 的 helper 方法 。 


Action Controller 
initializer 


Assets config 置 assets dir* Xi € public/ 
Set helpers path # Aix 
Parameters config 

Set configs 

Compile config methods 





app/helpers/ 


配置 可 通过 以 下 方式 查看 : 


Rails.configuration.action controller 


x 


Rails.application.config.action_controller 


默认 配置 项 : 


Rails.configuration.action controller.keys 


= ınarfnrm rarhinn "accaotce dir "lnOnnar ırarhr 
= | perrorm cacning, a5s5er5 ULT ] Ogger, .cacne 
aovi.lput» uir, 
C Tachant Ee I E AI = = : = 38 
stylesheets dir, :asset host, relative ur] 


Action Dispatch 


初始 化 configure 及 其 它 。 
Action View 


embed authenticity token in remote forms. 
logger. 

set configs. 

caching. 


setup action pack. 


Active Model 


Aa £X Action Model 相关 118n 


ActiveSupport.on load(:ii8n) do 

I18n.load path << File.dirname(__FILE__) + '/active model/loca 
le/en.yml' 
end 


Active Record 


b 


获取 database.yml 的 配置 信息 : 


Rails.application.config.database configuration 


Active Job 


logger 
set configs 
set reloader hook 


A? ELE X queue adapter 由 默认 的 inline 改 为 了 :async 
Active Support 


active support.deprecation behavior 

active support.initialize time zone 

active support.initialize beginning of week 
active support.set configs 


118n 


after initialize 和 before eager load 都 执行 initialize_i18n 


Engine 
Engine 下 有 Railtie， 上 有 Application. 


Your Application 


| 
V 


Application 


| 
V 


Engine 


| 
V 


Railtie 


在 Engine 里 ， 可 以 直接 使 用 Railtie 提供 的 方法 ; 
在 Application 里 ， 可 以 直接 使 用 Engine 提供 的 方法 。 


Engine = Ruby Gem + Rails MVC stack elements. 


使 用 Engine， 可 以 把 一 个 小 型 的 Rails 项 目 当成 组 件 ， 插 入 到 另 一 个 Rails 项 目 
里 。 


它 可 以 有 自己 的 MYC、 路 由 、Helper、Assets、Rake、Generator 与 配置 、 初 始 
化 ， 其 至 是 lib、Migration 和 测试 。 


和 一 般 gem 对 比 ，Engine 至 少 有 以 下 特点 : 


e 按照 约定 ， 遵 循 Rails 应 用 的 文件 、 目 录 结 构 
e 从 Railtie 继承 来 的 那 一 套 方法 ， 可 用 于 配置 、 初 始 化 
e 5 Rails 无 颖 集成 


Engine 文件 下 的 内 容 
对 外 提供 接口 
实例 方法 : 

app 

config 


eager load! 


endpoint 


env config 


helpers 
helpers paths 


load console 
load generators 
load runner 
load seed 

load tasks 


railties 


routes 


RAK: 


endpoint 


find 
find root 


isolate namespace 


isolated? & isolated 


engine name & railtie name 


其 它 方法 : 


delegate :middleware, 
delegate :engine name, 


有 哪些 initializer ? 


设置 load path 

设置 autoload paths 
添加 routing paths 

添加 locales 

添加 view paths 

加 载 environment config 
Append assets path 
Prepend helpers path 
加 载 config initializers 


ES a 


:root， :paths, 
to: 


:isolated?, 


to: 


:config 
:class 


Configuration 


Railtie » Engine ` Application 都 有 自己 的 Configuration 模块 。 


由 于 Ruby 的 继承 机 制 ， 我 们 常用 的 config 可 以 看 作 是 它们 中 任意 一 个 的 实例 
对 象 。 所 以 ， 理 论 上 来 说 ， 它 们 提供 的 接口 config 都 可 直接 调用 。 


对 外 提供 接口 


实例 方法 : 


paths 
eager load paths 
autoload paths 
autoload once paths 


middleware 
generators 


root 
root- 


generators 使 用 举例 : 


config.generators do |g| 
g.orm :data mapper, migration: true 
g.template engine :haml 
g.test framework :rspec 

end 


config.generators.colorize logging - false 


paths 通过 它 可 以 查看 Engine 默认 已 经 在 用 的 路 径 ， 当 我 们 定制 Engine 时 ， 按 
照 约定 放置 文件 、 目 录 有 是 个 好 习惯 。 


root 


Rails.configuration.root -- Rails.root 
# => true 


generators ` root= 外 ， 其 余 方法 都 是 get 获取 数据 ， 而 不 是 set 设置 数据 。 


另 ， 自 定义 的 Railtie 和 自 定 义 的 Engine， 也 可 以 对 外 提供 config 接口 。 


Engine full vs mountable 


生成 命令 rails plugin new 


常用 参数 --full 或 --mountable 


full 


main app 路 由 继承 于 Engine， 所 以 它们 用 的 路 由 是 同一 套 。 


# my engine/config/routes.rb 


Rails.application.routes.draw do 


end 


因此 ， 在 main app 的 config/routes.rb 里 不 用 做 任何 配置 ， 它 们 是 互通 的 。 
main app 会 继承 Engine 的 model ` controller ` routes 等 。 

也 就 是 说 它们 的 环境 是 一 样 的 。 

mountable 


首先 ， 从 路 由 上 讲 它们 是 隔离 开 的 : 


4 my engine/config/routes.rb 


MyEngine::Engine.routes.draw do 

end 

4 parent app/config/routes.rb 
ParentApp::Application.routes.draw do 


mount MyEngine::Engine -» "/engine", :as -» "namespaced" 
end 


HR > Engine 使 用 自己 的 命名 空间 : 


4 my engine/lib/my engine/engine.rb 
module MyEngine 
class Engine « Rails::Engine 
isolate namespace MyEngine 
end 
end 


再 者 ，Engine 创建 的 表 有 engine name 做 为 前 缓 。 


model ` controller ` routes 等 都 是 相互 隔离 的 。 


也 就 是 说 它们 的 环境 不 是 一 样 的 。 


推荐 使 用 mountable 


--full 仅 做 文件 、 目 录 上 的 分 隔 ， 实 际 上 我 们 没 必要 使 用 ， 有 其 它 方式 实现 
(如 : 使 用 命名 空间 )。 


--mountable 才 是 推荐 做 法 (从 Engine 存在 的 意义 及 文档 上 ， 可 以 看 出 这 点 )。 


定制 自己 的 Engine 
Engine = Ruby gem + Rails MVC stack elements. 


一 ， 创 建 自己 的 Engine 


可 用 命令 rails plugin new 创建 自己 的 Engine. 
常用 可 选 参数 --full 或 --mountable 


两 者 之 间 的 区 别 ， 可 以 参考 【Engine full vs mountable】 章 节 。 
HTT’ FRAMT : 
1) 继承 于 Rails::Engine， 一 般 把 它们 放 在 lib/ 目录 下 。 

# lib/my engine.rb 


module MyEngine 
class Engine < Rails::Engine 





2) 在 config/application.rb (或 Gemfile) € 47 # AX fF ° 


Engine 相关 的 model ` controller 和 helper 会 被 加 载 到 app/ € > route 会 被 加 载 到 
config/routes.rb, locale 会 被 加 载 到 config/locales, tasks 会 被 加 载 到 lib/tasks. 


4 config/application.rb 
require 'my engine/engine' 


4 Gemfile 
gem 'my engine', path: "/path/to/my engine" 


3) 在 routes.rb €. mount MyEngine::Engine 


Rails.application.routes.draw do 
mount MyEngine::Engine -» "/engine" 


end 


=» #5 my. engine/engine.rb 文件 内 容 

每 个 Engine 都 会 有 自己 的 engine.rb 文件 。 里 面 有 自己 的 Engine 类 ， 它 继承 于 
::Rails::Engine 

1) 常用 方法 之 config ` initializer 

在 这 文件 里 ， 你 可 以 使 用 config, initializer 等 方法 。 这 点 和 定制 Railtie 类 似 ， 但 不 
同 点 是 : 当前 Engine 的 配置 和 初始 化 ， 作 用 域 仅 限于 当前 Engine. 


class MyEngine < Rails::Engine 
# 添加 新 的 、 额 外 的 目录 到 autoload paths 


config.autoload paths «« File.expand path("../lib/some/path", 


. FILE ) 


initializer "my engine.add middleware" do |app| 
app.middleware.use MyEngine::Middleware 
end 
end 


config 是 个 方法 ， 但 同时 它 也 是 Configuration 的 实例 对 象 ， 所 以 你 可 以 使 用 


config.generators : 


class MyEngine « Rails::Engine 
config.generators do |g] 
g.orm active record 


g.template engine :erb 
g.test framework :test_unit 


end 
end 


还 可 使 用 config.app generators 


class MyEngine « Rails::Engine 


# note that you can also pass block to app generators in the s 


d 


ame way you 
# can pass it to generators method 


config.app_generators.orm :datamapper 
end 


2) 常用 方法 之 isolate namespace 


默认 Engine 和 应 用 是 在 一 个 环境 里 的 ， 这 意味 着 应 用 所 有 helper 和 命名 路 由 都 可 
以 在 Engine 里 使 用 。 


你 可 以 使 用 isolate_namespace 更 改 此 项 默认 配置 ， 将 Engine 和 应 用 隔离 出 
来 。 使 用 举例 : 


module MyEngine 
class Engine « Rails::Engine 
isolate namespace MyEngine 
end 
end 


此 时 MyEngine 和 应 用 是 隔离 了 的 ， 假 设 MyEngine 有 代码 : 


module MyEngine 


class FooController < ActionController::Base 
end 
end 


此 时 FooController 仅 能 使 用 Engine 里 提供 的 helper > RA 
MyEngine::Engine.routes 提供 的 url helper. 


另外 一 个 改变 就 是 Engine 里 的 路 由 不 必 再 使 用 namespace， 举 例 : 
MyEngine::Engine.routes.draw do 


resources :articles 
end 


resources :articles 自动 对 应 着 MyEngine::ArticlesController . 并且 不 必 使 用 


长 长 的 url helper， 例 如 my engine articles path 可 以 直接 使 用 
articles path 


^ & isolate namespace 影响 的 就 是 对 于 model 的 调用 ， 仍 然 使 用 engine name 
做 为 前 级。 例如 以 下 例子 的 MyEngine::Article 


polymorphic url(MyEngine::Article.new) # => "articles path" 


form for(MyEngine::Article.new) do 
text field :title 


H 


=> <input type="text" name="article[title]" id-"article titl 


另 一 个 改变 是 对 表 名 的 更 改 。 默 认 使 用 engine name (在 这 里 是 "my_engine") 做 为 
表 前 级 ， 也 就 是 说 MyEngine::Article 对 应 的 表 名 应 该 是 my_engine_articles 


3) 常用 方法 之 paths 


Engine 默认 都 有 自己 的 文件 、 目 录 结 构 ， 如 果 你 没有 定制 ， 那 么 就 使 用 默认 的 : 


"app", 
"app/assets", 
"app/controllers", 
"app/helpers", 
"app/models", 
"app/mailers", 
"app/views" 


eager_load: true, glob: "*" 


glob: 


"nx 


eager load: true 


eager load: true 


eager load: true 


eager load: true 


"app/controllers/concerns", eager load: true 


"app/models/concerns", 


np s 
"lib/assets", 
"lib/tasks", 


"config, 
"config/environments", 
"config/inTtializers”, 
"config/locales", 
"config/routes.rb" 


"gb" 
"db/migrate" 
"db/seeds.rb" 


"vendor", 
"vendor/assets", 


eager load: true 


load path: true 


glob: 
glob: 


glob: 
glob: 
glob: 


nx" 


UA AER " rake" 


"#{Rails.env}.rb" 
Wa/ 
lm 


load path: true 


glob: 


"nx 


paths 通过 它 ， 可 以 更 改 默认 的 文件 、 目 录 结 构 。 


举例 ， 你 想 把 controller 文件 放 到 lib/ 目录 下 : 


class MyEngine < Rails::Engine 


paths["app/controllers"] = "lib/controllers" 


end 


再 或 者 ，controller 在 app/ 和 lib/ 下 都 可 接受 : 


34 


Qo 


8 


class MyEngine « Rails::Engine 
paths["app/controllers"] «« "lib/controllers" 
end 


Application 在 Engine 之 上 ， 它 又 有 自己 的 配置 和 初始 化 。 它 配置 了 app/ 下 的 文 
件 、 目 录 会 被 自动 加 载 ， 所 以 像 app/services 会 被 自动 加 载 。 


4) 常用 方法 之 endpoint 


Engine 内 容 也 可 以 是 一 个 Rack Application. 当 你 的 代码 本 身 是 Rack Application > 
而 又 想 使 用 Engine 的 特性 时 ， 可 以 这 么 做 : 


1) 在 自己 定义 的 Engine 里 ， 使 用 endpoint : 


module MyEngine 
class Engine « Rails::Engine 


# Engine 的 内 容 就 是 MyRackApplication 
endpoint MyRackApplication 
end 


end 


2) 和 平常 一 样 ， 在 route 里 mount 你 的 Engine: 


Rails.application.routes.draw do 
mount MyEngine::Engine => "/engine" 
end 


5) 常用 方法 之 middleware 


Engine 内 容 也 可 以 是 一 个 Middleware. 当 你 的 代码 本 身 是 Middleware， 而 又 想 使 
用 Engine 的 特性 时 ， 可 以 这 么 做 : 


module MyEngine 
class Engine « Rails::Engine 
# Engine 的 内 容 就 是 SomeMiddleware 





middleware.use SomeMiddleware 
end 
end 


6) 常用 方法 之 engine name 

用 几 个 场景 可 能 会 用 到 engine name: 
e routes: 当 你 使 用 mount(MyEngine::Engine => '/my engine") 
e rake task: 当 你 使 用 my_engine:install:migrations 


Engine name 默认 根据 类 名 而 来 ， 如 MyEngine::Engine 对 应 有 


my engine engine .你 可 以 使 用 engine name 进行 自 定 义 : 


module MyEngine 
class Engine « Rails::Engine 


engine name "my engine" 
end 
end 


三 ， 编 写 Engine A € 
做 了 上 述 两 步 后 ， 就 是 编写 内 容 。 该 做 什么 事 ， 做 什么 事 ; 该 完成 什么 功 和 
什么 功能 。 


GG 
e 


w * # main app 引入 定制 的 Engine 
也 就 是 : 


在 config/application.rb (或 Gemfile) 里 加 载 本 文件 。 
在 routes.rb €. mount MyEngine::Engine 


HE 


mount as -在 Engine 之 外 使 用 其 路 由 


mount( 挂 载 ) 后 Engine 和 应 用 之 间 的 路 由 仍然 是 独立 的 ， 你 仍然 不 能 在 应 用 里 直接 
使 用 Engine 里 面 的 路 由 。 举 例 : 


4 config/routes.rb 
Rails.application.routes.draw do 
mount MyEngine::Engine => "/my engine", as: "my engine" 
get "/foo" => "foo#index" 


end 


Engine 外 面 ， 使 用 my engine 访问 Engine 里 面 的 路 由 : 


class FooController < ApplicationController 
def index 
my engine.root url # => /my engine/ 
end 
end 


Engine 里 面 ， 使 用 main app 访问 Engine 外 面 的 路 由 : 


module MyEngine 
class BarController 
def index 
main app.foo path # => /foo 
end 
end 
end 


:as 可 选项 默认 使 用 的 是 engine name ， 所 以 通常 你 可 以 省 略 它 。 


还 有 一 种 情况 ， 需 要 传递 engine_name 以 便 生 成 路 由 ， 举 例 : 


form for([my engine, Quser]) 


这 里 生成 的 路 由 规则 类 似 my engine.user path(Quser) 


helper - Isolated engine's helpers 


有 时 候 ， 你 的 Engine X Isolated > 124% X 284€ f] Engine 里 面 定义 的 helper > RT 
以 引入 茶 个 模块 : 


class ApplicationController < ActionController::Base 
helper MyEngine::SharedEngineHelper 
end 


或 者 ， 引 入 Engine 里 面 所 有 的 helper 模块 : 


class ApplicationController < ActionController::Base 
helper MyEngine::Engine.helpers 
end 


Note: 这 里 引入 的 只 是 helpers 目录 下 的 文件 ， 在 Controller 里 定义 ， 然 后 使 用 
helper method 的 方法 不 包含 在 内 。 


Migrations & seed data 


Engine 也 可 以 有 自己 的 迁移 文件 ， 和 普通 应 用 一 样 ， 它 们 位 于 db/migrate 下 
Ee 


你 可 以 运行 以 下 命令 ， 将 Engine 里 的 迁移 文件 复制 到 应 用 里 : 


rake ENGINE NAME:install:migrations 


Engine 也 可 以 有 自己 的 seed 文件 ， 它 们 位 于 db/seeds.rb 下 面 。 


你 可 以 运行 以 下 命令 ， 将 Engine 里 的 seed 文件 复制 到 应 用 里 : 


MyEngine::Engine.load seed 


PX E ho RMR > Do Zo RK 


场景 
- app 
- Views 
- shared 
- _header.html.erb «-- 实际 泻 染 的 却 是 这 个 
- config 
- vendors 
- plugins 
- myplugin 
- app 
- views 
- controlleri 
- actioni.html.erb «-- 在 这 里 泻 业 
- Shared 


- header.html.erb «-- 希望 泻 染 的 是 这 个 
<%= render 'shared/header' 96» 


= 


按照 直观 的 理解 ， 泻 染 的 应 该 是 第 2 个 模板 。 但 实际 情况 却 不 是 ， 所 以 需要 我 们 配 
Boo 


你 可 以 使 用 config.railties_order 改变 Engine 以 及 应 用 的 加 载 顺序 : 


4 load Blog::Engine with highest priority, followed by applicati 
on and other railties 
config.railties order - [Blog::Engine, :main app, :all] 


main app 表示 我 们 的 项 目 本 身 ， 在 Application::Finisher €. X 3. > all 表示 所 有 其 
它 的 Railtie， 在 Application::Configuration 里 初始 化 时 定义 。 


Note: 上 面 的 例子 ， 你 也 可 以 用 其 它 手段 完成 ， 如 namespace 等 。 


迁移 文件 


rake my engine:install:migrations 


提示 


除了 initializer 外 ，rake tasks 也 会 被 复制 到 main app 里 。 所 以 ， 有 时 候 你 会 看 
到 提示 : 


"Copy migrations from £Z(railtie name) to application" 


Application 
Application 继承 于 Engine， 负 责 协 调整 个 启动 过 程 ， 包 括 : 配置 、 初 始 化 。 


配置 


除了 和 Engine ^ Railtie 有 一 样 的 配置 项 外 ， 它 新 增 了 自己 的 配置 项 ， 如 : 
cache classes ` consider. all requests local 、filter_parameters、logger 等 。 


和 我 们 的 配置 直接 相关 : 


Rails.configuration == Rails.application.config 
-» true 


Rails.configuration.class 
-» Rails::Application::Configuration 
初始 化 


Application 负责 执行 所 有 Railtie 和 Engine 的 初始 化 任务 。 可 分 为 前 期 准备 任务 
Bootstrap， 和 后 期 收尾 任务 Finisher. 


Application 文件 下 的 内 容 
实例 方法 : 

console 

generators 

rake_tasks 

runner 

initializer 

isolate namespace 


key. generator 
message verifier 


reload routes! 
initialized? 
config for 
helpers paths 


find root 


env config 


secrets 


类 方法 : 


create 


除了 以 上 对 外 提供 的 接口 外 ， 它 还 有 一 些 很 有 用 的 方法 。 但 不 属于 对 外 提供 接口 ， 
如 : 


initialize! 


明确 使 用 到 的 其 它 类 和 模块 : 


require 'active support/key generator' 


require 'active support/message verifier 


require 'rails/engine' 


autoload 
autoload 
autoload 
autoload 
autoload 
autoload 


:Bootstrap 

: Configuration 
:DefaultMiddlewareStack 
:Finisher 

:Railties 
:RoutesReloader 


Bootstrap 打 前 锋 
include by Application. 


we TONS 
加 载 active support 

设置 eager load 

初始 化 logger 

初始 化 cache 

初始 化 dependency mechanism 


Beetstraphoek 


Finisher 收尾 


include by Application. 


添加 generator templates 

Ensure autoload once paths as subset 
添加 builtin route 

构建 middleware stack 

定义 main app helper( 使 用 Engine 时 ， 一 个 比较 重要 的 概念 ) 
添加 to prepare blocks 

运行 prepare callbacks 

Eager load! 

Finisher-heok 

设置 routes reloader hook 

设置 clear dependencies hook 


Bs 
main app 可 以 让 你 确保 使 用 的 是 主 应 用 所 在 的 环境 ， 当 你 使 用 了 mountable 
Engine 时 ， 这 点 可 能 很 重要 。 


Configuration 


Railtie » Engine ` Application 都 有 自己 的 Configuration 模块 。 


由 于 Ruby 的 继承 机 制 ， 我 们 常用 的 config 可 以 看 作 是 它们 中 任意 一 个 的 实例 
对 象 。 所 以 ， 理 论 上 来 说 ， 它 们 提供 的 接口 config 都 可 直接 调用 。 


对 外 提供 接口 : 


attr accessor :allow concurrency, :asset host, :assets, :autoflu 
sh log, 

:cache classes, :cache store, :consider all reques 
ts local, :console, 

:eager load, :exceptions app, :file watcher, :filt 
er parameters, 

:force ssl, :helpers paths, :logger, :log formatter 
, :1log tags, 

:railties order, :relative url root, :secret key b 
ase, :secret token, 

:serve static assets, :ssl options, :static cache. 
control, 

:session options, :time zone, :reload classes only 
. on change, 

:beginning of week, :filter redirect, :x 


attr writer :log level 
attr reader :encoding 


BES SS o ëO 
有 以 下 方法 : 


annotations 

colorize logging 
database configuration 
log level 

paths 


session store 


paths FRY Engine 包含 的 文件 、 目 录 结 构 外 


paths.add "config/database", with: 
paths.add "config/secrets", with: 
paths.add "config/environment", with: 
paths.add "lib/templates" 

paths.add "log", with: 
paths.add "public" 

paths.add "public/javascripts" 
paths.add "public/stylesheets" 
paths.add "tmp" 


， 这 里 有 : 


"config/database.yml" 
"config/secrets.yml" 
"config/environment.rb" 


"log/#{Rails.env}.log" 


另 ， 自 定义 的 Railtie 和 自 定义 的 Engine， 也 可 以 对 外 提供 config 接口 。 


Default Middleware Stack 


配置 Rails 项 目 默 认 的 middleware stack. 
相关 方法 为 build stack ^» # Finisher 里 有 调用 到 。 


可 以 通过 以 下 命令 查看 : 


Rails.application.send(:default middleware stack) 


如 下 : 
Rack: :Sendfile 


ActionDispatch::Static 
ActionDispatch::LoadInterlock 


Rack: :Runtime 
Rack: :MethodOverride 


ActionDispatch: :RequestId 
Rails: :Rack: : Logger 


ActionDispatch: :ShowExceptions 
ActionDispatch: :DebugExceptions 
ActionDispatch: :RemoteIp 
ActionDispatch: :Reloader 
ActionDispatch: :Callbacks 
ActionDispatch: :Cookies 
ActionDispatch: :Session: :CookieStore 
ActionDispatch: :Flash 


Rack: :Head 
Rack: :ConditionalGet 
Rack: :ETag 


Default Middleware Stack 
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Rails 应 用 启动 过 程 


1) 入 口 config.ru 


require ::File.expand path('../config/environment', | FILE ) 


2) # A environment.rb 


require File.expand path('../application', _ FILE ) 


3) && A application.rb 


require File.expand path('../boot', _ FILE ) 


4) 42 A boot.rb 


ENV['BUNDLE GEMFILE'] ||» File.expand path('../../Gemfile', 


LE ) 


5) Gemfile 


gem 'gem name' 


6) 加 到 boot.rb 

执行 bundle 

7) application.rb 

7.1) require 'something' # like require 'rails' 

7.2) AppName::Application « Rails::Application 

7.3) config your AppName! 在 上 一 步 继承 之 后 就 已 经 有 配置 了 。 


8) enviroment.rb 


RET 


AppName::Application.initialize! 


# Initialize the application passing the given group. By default 
, the 
4 group is :default 
def initialize! (group=:default) #:nodoc: 

raise "Application has been already initialized." if @initiali 
zed 

run_initializers(group, self) 

@initialized = true 

self 
end 


8.1) Bootstrap 
8.2) 默认 的 Railtie, Engine, Application 
8.3) 定制 的 Railtie, Engine 


构建 middleware stack. 
(Rails.application.send :middleware &# middleware, 顺序 从 前 到 后 ) 
(Rails.application.send :default_middleware_stack 查看 middleware, 顺序 是 默认 ) 


8.4) Finisher 


Rails::Application - config/application.rb 


Rails::Railtie::Configuration - configuration.rb 


config/application.rb €. 2 require 再 config 最 后 eager. load. 


相关 代码 : 


AppName.initialize! 


run initializers(group, self) 


initializers.tsort each do |initializer | 
initializer.run(*args) if initializer.belongs to?(group) 
end 


Qinitializers ||= self.class.initializers for(self) 
Collection.new(initializers chain.map { |i| i.bind(binding) }) 
def initializers chain 
initializers - Collection.new 
ancestors.reverse each do |klass| 
next unless klass.respond to?(:initializers) 
initializers = initializers + klass.initializers 
end 
initializers 
end 


def run(*args) 
@context.instance_exec(*args, &block) 
end 


各 样 的 钧 子 ， 如 : 
before configuration 
before eager load 
before initialize 


after initialize 


它们 在 Railtie::Configuration 里 定义 ， 使 用 范围 很 广 。 


US T X initializer! 


Application 补 元 


TODO 


Routes Reloader 


充分 运用 了 File Update Checker， 当 "路 由 "相关 文件 有 改动 时 ， 可 以 实现 自动 重新 
加 载 。 


开发 环境 下 ， 不 用 重启 ， 重 新 加 载 路 由 : 


Rails.application.reload routes! 


相关 代码 : 


def reload! 
clear! 
load paths 
finalize! 

ensure 
revert 

end 


这 部 分 ， 更 多 信息 可 以 查看 "Active Support autoload 的 类 和 模块 "下 面 的 【File 
Update Checker】 章 节 。 


由 rake 和 rails 两 部 分 组 成 。Rails 5 以 后 这 两 个 命令 统一 成 了 rails * 12 rake 仍然 
可 以 使 用 。 


rake 


tasks.rb 及 tasks 目录 
都 有 单独 的 rake 文件 ， rake -T 包含 但 不 限于 这 下 面 的 命令 : 


annotations(notes) 
initializers 
framework(rails) 

log 

middleware 
misc(secret ` about ` time) 
routes 

tmp 

rails(update ` template) 
restart 

engine(app ^ db) 
statistics(stats) 


e Code Statistics 


e Code Statistics Calculator 


大 大 ”一 


Rakefile 里 的 Rails.application.load tasks 会 加 载 本 应 用 使 用 到 第 三 方 
Railtie 和 Engine > X Rails 自身 (按照 约定 lib/tasks 也 包含 在 内 ) 所 定义 的 rake f£ 


务 。 


可 以 只 查看 和 某 一 命名 空间 有 关 的 rake 任务 ， 例 如 和 notes 相关 的 任务 : 
$ rake -T notes 


rake notes 
rake notes:custom 


Source Annotation Extractor 


和 上 面 列 举 的 : 
rake notes 
rake notes:optimize 等 相关 。 


api 
rake rdoc (Rails 自身 的 API) 


test_unit 
rake test 


还 可 再 细 分 为 models ^ helpers ` controllers ` mailers ` integration fe jobs 等 。 


rails 


commands 
rails 可 接 以 下 命令 : 


application 
console 
dbconsole 
destroy 
generate 
plugin 
runner 
Server 
update 


commands tasks 
常用 的 有 : 


e generate 
e console 

e Server 

e dbconsole 
e new 


rake & rails 命令 


VAR: 


e destroy 
e plugin new 
e runner 


Note: 迁移 相关 在 Active Record 里 的 databases.rake €. X 3. ° 
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rails console 里 的 小 技巧 


1) app 


会 话 实例 ， 可 用 于 集成 测试 。 


通过 它 可 以 做 一 些 你 在 集成 测试 里 要 做 的 事 。 


app.clas 


-» ActionDispatch: 


new app 
session 


S 


:Integration::Session 


Rails.application 
:Integration::Session.new(new app) 


ActionDispatch: 


session.class 


-» ActionDispatch: 


e 所 有 的 path 和 url (这 
e request.methods 


e response.methods 
e 相关 的 asset .methods 
e ActionController::Base 引入 的 private 等 方法 


2) new session 


返回 一 个 新 的 集成 测试 会 话 实例 


3) reload! 


重新 加 载 环 境 。 这 个 应 该 很 熟悉 这 


4) helper 


ActionView::Base 实例 。 通过 


方法 (这 里 不 包 


& path 和 url) ° 


:Integration::Session 


包含 其 它 helper) 


这 个 最 常用 ， 当 修改 了 env 配置 的 时 候 ， 需 要 重 
新 加 载 。 使 用 这 个 方法 可 以 不 必 退 出 后 在 尼 动 。 


它 可 以 直接 使 用 view 的 方法 等 ， 例 如 


: 所 有 helper 


module UsersHelper 
def user help 1(user name) 
puts "I am June!" 
end 


def user help 2 
puts "I am June-Lee!" 
end 
end 


# 原理 类 似 


helper.send :extend, UsersHelper 


5) controller 
ApplicationController 实例 。 可 以 直接 使 用 ApplicationController 的 方法 等 。 


其 它 
以 下 有 的 内 容 并 非 Rails 专 有 ， 但 很 实用 ， 一 并 列 出 。 
e method 的 使 用 


# 方法 定义 的 地 方 
x.method(:method name).source location 


# 方法 内 容 


x.method(:method name).source 


H 方法 前 面 的 注释 说 明 


x.method(:method name).comment 


# X 可 以 是 对 象 、 类 、 模 块 等 


o 在 执行 语句 后 面 加 分 号 ( ; )， 可 去 掉 console 默认 的 打印 输出 。 
e 下划线 (_) 可 以 显示 上 条 正确 命令 执行 的 结果 。 


e Console 清 屏 快捷 键 "Ctrl + 上 "或 "Command + K" 


e 定制 自己 的 console 方法 


举例 ， 我 们 使 用 gem 'factory_girl' > HÈ SEAT SRILA FH? ANA fg 
代替 FactoryGirl， 可 以 这 么 做 : 


# config/environments/test.rb 
module Rails 
module ConsoleMethods 
def fg 
Qfg ||» FactoryGirl 
end 
end 
end 


。 使 用 Pry 代替 IRB 


4 config/application.rb 
config.console do 
require 'pry' 
config.console - Pry 
end 


(如 果 使 用 gem 'pry-rails', 默认 已 经 用 pry 代替 irb) 
e 使 用 y_ 
格式 化 重新 输出 上 次 内 容 。 


344% -Root 和 Path 
包括 Root & Path > /2 Root 已 经 封装 了 Path, 并 且 只 有 Root 对 外 提供 接口 。 


Root 


Rails.application.paths 
提供 方法 : 

add 

all paths 

autoload once 

autoload paths 


eager load 
load paths 


和 
keys 


values 
values at 


Path 


Path 元 编程 提供 的 几 个 方法 ， 也 插 有 用 的 : 


路 径 -Root 和 Path 


%w(autoload_once eager load autoload load path).each do |m] 


class eval ««-RUBY, 
def #{m}! 
@#{m} = 


end 


true 


def skip_#{m}! 
@#{m} = false 
end 


def #{m}? 
@#{m} 
end 
RUBY 
end 


3 » Path 行为 和 数组 有 点 类 似 ， 并 且 它 还 


也 可 用 。 





EDEN LINE +1 
def eager_load! 
@eager_load = true 


end 


def skip_eager_load! 
@eager_load = false 
end 


def eager_load? 


@eager_load 
end 


include Enumerable 


> 所 以 部 分 操作 
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提示 信息 页 面 


ApplicationController 

这 里 指 的 是 Rails 自 带 的 Rails::ApplicationController, 不 是 我 们 Controller 里 继承 
的 Application. 

它 和 Application 没有 对 应 关系 ， 只 是 下 面 几 个 Controller 的 父 类 。 


WelcomeController 
新 建 Rails 项 目 ， 没 有 任何 路 由 及 内 容 时 ， 默 认 显 示 的 首页 index. 


MailersController 
邮件 预览 的 列表 index 和 详情 preview 9t ° 


InfoController & Info 

项 目 信 息 页 面 ， 包括 Rails、Ruby、Rack 版 本 等 。 

有 页 面 : index( 同 routes) 和 properties. 

默认 首页 里 点 击 " About your application's environment" 可 查看 其 内 容 。 


x 


/一 > 


7. 65 


TODO 


Rails 文件 下 的 内 容 


这 里 指 的 是 class Rails. 因为 它 与 框架 同名 ， 所 以 这 里 会 加 大 它 的 重要 指数 ， 下 面 
就 说 说 我 们 常用 的 几 个 类 方法 。 


类 方法 解释 
application oe 的 应 用 ， 它 是 AppName::Application 的 实例 对 
我 们 应 用 的 配置 相关 信息 ， 它 是 
Se Rails::Application::Configuration 的 实例 对 象 
on 我 们 应 用 所 处 环境 ， 它 是 ActiveSupport::StringInquirer 
的 实例 对 象 
root 获取 项 目 root 路 径 
cache 缓存 实例 对 象 
logger 日 志 实 例 对 象 


backtrace cleaner ” 它 是 Rails::BacktraceCleaner 的 实例 对 象 


public_path 获取 项 目 public/ 路 径 


Configuration Middleware Stack Proxy 


我 们 常用 的 config.middleware * X X € Middleware Stack Proxy 的 实例 对 
象 。 对 应 Rails::Configuration::MiddlewareStackProxy 


被 Railtie 所 调用 ， 又 由 于 继承 关系 ，Engine、Application、YourApp 都 可 用 。 
实例 方法 : 


use 


config.middleware.use Magical::Unicorns 


insert before & insert 


config.middleware.insert before ActionDispatch::Head, Magical::U 
nicorns 


insert after 


config.middleware.insert after ActionDispatch::Head, Magical::Un 
icorns 


swap 


config.middleware.swap ActionDispatch::Flash, Magical::Unicorns 


delete 
config.middleware.delete ActionDispatch::Flash 
除 以 上 方法 外 ， 还 有 : 


unshift 


运用 上 述 方 法 ， 我 们 可 以 增加 、 删 除 Middleware > 或 改变 Middleware 加 载 顺序 。 


Configuration Middleware Stack Proxy 
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AppName, Application, Engine, Railtie 
从 上 层 到 底层 。 


AppName < Application < Engine < Railtie 


最 直观 的 就 是 文件 、 目 录 结 构 ， 以 及 配置 文件 。 其 次 ， 是 默认 组 件 。 


默认 组 件 都 是 Railtie 


active record, action controller, action view, action mailer, rails/test unit, 
sprockets 还 有 active model 都 属于 Railtie. 


查看 配置 有 哪些 eager_ load namespaces 


Rails.configuration.eager load namespaces 


-» [ActiveSupport, 
ActionDispatch, 
ActiveModel, 
ActionView, 
ActionController, 
ActiveRecord, 
ActionMailer, 


Coffee: :Rails: :Engine, 
Jquery: :Rails: :Engine, 
Turbolinks: :Engine, 


WebConsole: :Engine, 


YourAppName: : Application] 


这 部 分 ， 更 多 信息 可 以 查看 "Railtie" 下 面 的 【Configuration】 章 节 。 


查看 应 用 有 哪些 Initializer 


AppName, Application. Engine, Railtie 


Rails.application.initializers.map &:name 


=> [:1oad environment hook, 

:load active support, 

:set eager load, 

:initialize logger, 

:initialize cache, 

:initialize dependency mechanism, 
:bootstrap hook, 

# 以 上 来 自 Bootstrap 


"active support.deprecation behavior", 

"active support.initialize time zone", 

"active support.initialize beginning of week", 
"active support.set configs", 

# 以 上 来 自 Active Support 


"action dispatch.configure", 
# 以 上 来 自 Action Dispatch 


"active model.secure password", 
4 以 上 来 自 Active Model 


"action view.embed authenticity token in remote forms", 
"action view.logger", 

"action view.set configs", 

"action view.caching", 

"action view.setup action pack", 

# 以 上 来 自 Action View 


"action controller.assets config", 

"action controller.set helpers path", 
"action controller.parameters config", 
"actronscontroller-set-^configs", 

"action controller.compile config methods", 
# 以 上 来 自 Action Controller 


"active record.initialize timezone", 
"active record.logger", 
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AppName, Application. Engine, Railtie 


"active record.migration error", 

"active record.check schema cache dump", 
"active record.set configs", 

"active record.initialize database", 
"active record.log runtime", 

"active record.set reloader hooks", 
"active record.add watchable files", 

4 以 上 来 自 Active Record 


iiODallgma ee 
# 以 上 来 自 gem 'globalid' 
# Active Job 依赖 于 它 


"active job.logger", 
"active job.set configs", 
4 以 上 来 自 Active Job 


"action mailer.logger", 

"action mailer.set configs", 

"action mailer.compile config methods", 
4 以 上 来 自 Action Mailer 


:setup_sass, 
:setup_compression, 
# 以 上 来 自 gem 'sass-rails' 


:jbuilder, 
# 以 上 来 自 gem 'jbuilder' 


:set load path, 

:set autoload paths, 

:add routing paths, 

:add locales, 

:add view paths, 

:load environment config, 
:append assets path, 
:prepend helpers path, 
:load config initializers, 
:engines blank point, 

# 以 上 来 自 Engine 
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# KH Engine’ €... 


:turbolinks, 
# 以 上 来 自 gem 'turbolinks' 


"web console.initialize view helpers 
"web console.add default route", 

"web console.process whitelisted ips", 
"web console.process command", 

"web console.process colors", 

# 以 上 来 自 gem 'web console' 


# KH Engine’ €... 


:initialize dependency mechanism, 
4 以 上 来 自 Bootstrap 


:add generator templates, 
:ensure autoload once paths as subset, 
:add builtin route, 

:build middleware stack, 
:define main app helper, 

:add to prepare blocks, 

:run prepare callbacks, 
:eager load!, 

:ifinisher hook, 

:set routes reloader hook, 
:set clear dependencies hook] 
# 以 上 来 自 Finisher 


这 部 分 ， 更 多 信息 可 以 查看 "其 它 "对 应 的 【Initializable】 章 节 。 


Backtrace Cleaner 


是 运用 ， 而 不 是 定义 ， 定 义 于 ActiveSupport::BacktraceCleaner. 


使 用 类 似 : 


bc = BacktraceCleaner.new 


4 Z yJ -© {RAAME hA RZ WAL Daile r + 
FRI: (ep a) MRA SEN Rails.root 


bc.add_filter { |line| line.gsub(Rails.root.to_s, '') } 


CX: (fT) mongrel X rubygems 里 记录 的 内 容 


bc.add silencer { |line| line =~ /mongrel|rubygems/ } 


执行 


bc.clean(exception.backtrace) 


Rails 里 用 Rails.backtrace cleane 替换 上 面 的 bc. 


Rack Logger 


用 于 日 志 记 录 ， 上 默认 已 经 添加 到 middleware 堆栈 。 


Generators 


包含 了 几乎 所 有 generator 48 X «iR > AZ [Generators] 3X $ > 


Generators 


把 常见 的 手动 操作 ， 用 命令 来 实现 。 
执行 generator 时 ， 会 按 先 后 顺序 执行 每 一 个 public 方法 。 
文件 、 目 录 、 参 数 、 操 作 | 


使 用 方式 : 
rails generate GENERATOR [args] [options] 


如 果 ， 你 记 不 住 这 么 多 命令 ， 不 要 紧 ， 按 按照 手动 操作 ， 然 后 自己 实现 也 是 可 以 
的 。 


该 目录 下 ， 还 有 Rails 自 带 的 generator 的 源 代 码 ， 它 们 可 供 参 考 。 


Note: 源 代码 放 在 railties 子 目 录 里 ， 所 在 路 径 railties/lib/rails/generators 


Thor 


Thor 和 rake 类 似 ， 提 供 了 功能 强大 的 命令 行 接口 。 


因为 Rails 的 generator 实际 上 是 封装 了 Thor ， 所 以 还 有 Thor Actions 


Actions 实例 方法 : 


action 


封装 一 个 实例 对 象 ， 并 调用 它 。 


append to file 
向 文件 里 追加 文本 内 容 。 


append to file 'config/environments/test.rb', 


apply 
加 载 并 执行 文件 。 


apply "recipes/jquery.rb" 


chmod 


更 改 文件 或 目录 的 权限 。 


chmod "script/server", 0755 


comment lines 
注释 指定 文件 里 面 符合 条 件 的 行 。 


'config.gem "rspec 


comment lines 'config/initializers/session store.rb', /cookie st 


ore/ 


copy file 
复制 文件 。( 默 认 源 文件 放 在 source root F) 


copy file "README", "doc/README" 


create file & add file 
创建 新 文件 。 


create file "config/apache.conf", "your apache config" 


create link(destination, *args, &block) (also: £add link) 
创建 一 个 链接 文件 。 


create link "config/apache.conf", "/etc/apache.conf" 


destination root 
返回 目标 目录 。 


destination_root=(root) 
设置 目标 目录 。 


directory 
按 规则 复制 整个 目录 。( 并 不 是 直接 复制 ， 注 意 转 换 规则 ) 


# 源 文件 、 目 录 如 下 : 

doc/ 
components/.empty_directory 
README 
rdoc.rb.tt 
%app_name%.rb 


# 复制 整个 目录 : 
directory "doc" 


# 得 到 目标 文件 、 目 录 : 
doc/ 
components/ 
README 
rdoc.rb 
blog.rb 


empty directory 
创建 一 个 空 目 录 。 


empty directory "doc" 


find in source paths 
在 源 目录 里 查找 文件 。 


get 
获取 内 容 并 放 到 文件 里 。 


get "http://gist.github.com/103208", "doc/README" 


gsub file 
按 正 则 替换 文件 内 容 。 


gsub file 'README', /rake/, :green do |match| 
match «« " no more. Use thor!" 
end 


in root 


到 根 目录 执行 block 里 的 代码 。 


inject into class 
将 内 容 插入 到 指定 的 文件 ， 指 定 的 class /6 @ » (Fo insert into file 更 精确 ) 


inject into class "app/controllers/application controller.rb", A 
pplicationController do 

" filter parameter :password\n" 
end 


insert into file & inject into file 
将 内 容 插 入 到 指定 的 文件 内 。( 如 : 添加 js 文件 后 ， 一 般 会 在 application.js 里 插入 
require 等 代码 ) 


insert into file "config/environment.rb", 
"config.gem :thor", 
‘after => "Rails::Initializer.run do |config|\n" 


K O nj 








inside 


在 根 目 录 或 指定 的 目录 里 执行 block 里 的 代码 。 
link file 
链接 文件 。 


link file "README", "doc/README" 


prepend to file & prepend file 
在 文件 开头 处 追加 文本 内 容 。 


prepend to file 'config/environments/test.rb', 'config.gem "rspe 
ecu 


relative to original destination root 
以 目标 为 根 目 录 ， 获 取 相 对 路 径 。 
remove file & remove dir 


移 除 文件 。 


remove file 'README' 


inside('vendor') do 
run('ln -s ~/edge rails') 
end 


run_ruby_script 
运行 Ruby 脚本 。( 照 顾 WIN32 的 用 户 ) 


source paths 
得 到 源 路 径 。( 方 便 后 续 操作 ) 


template 
复制 示例 模板 文件 ， 生 成 新 的 ERB 文件 。 


thor 
运行 thor 命令 。 


thor :list, :all => true, :substring => 'rails' 


uncomment lines 


去 掉 指 定 文件 里 符合 条 件 的 行 的 注释 。 


uncomment lines 'config/initializers/session store.rb', /active 
record/ 


Actions 类 方法 : 


add runtime options! 


添加 了 force ` pretend ` quiet ` skip 这 几 个 class option. 


source paths 
存储 并 返回 定义 这 个 类 所 在 的 位 置 
source paths for search 
获取 source paths ^ source root(Zj #774) ` source paths( 3: # &7) 


source root 
存储 并 返回 定义 这 个 类 所 在 的 位 置 。(Base 已 经 覆盖 此 方法 ) 


argument 

给 我 们 的 "命令 行 "添加 参数 ， 并 有 attr accessor 

(注意 : 这 里 的 参数 区 别 于 类 或 方法 里 的 参数 、 可 选 参数 ) 
示例 : 


+ 这 里 的 [method method] 


rails g mailer NAME [method method] [options] 


ClassNamezZpublic instance method 
一 般 的 ， 类 名 会 被 当做 namespace， 而 实例 方法 会 被 当做 task， 也 就 是 : 


class name:public instace method 


(实例 方法 的 参数 仍 被 当做 参数 对 待 ) 


desc 
对 task 的 描述 。 
method option 和 method options 


使 用 task 时 传递 的 可 选 参 数 。 


invoke 


调用 方法 (为 什么 不 直接 调用 ? ) 


Thor: : Group 
继承 于 它 的 话 ， 下 面 的 实例 方法 会 被 当成 "组 "， 会 按照 定义 顺序 执行 。 


ni 


class option 和 class options 
使 用 task 时 传递 的 可 选 参数 。( 配 合 Thor::Group 很 好 ) 


namespace 
定义 namespace (不 使 用 默认 以 ClassName 生成 的 ) 


ClassName.start 

可 以 把 task 封装 成 可 执行 命令 ， 不 必用 thor 命令 。 这 是 启动 命令 ， 通 常 放 在 最 
后 。 

option 和 options 

可 选 参数 (如 : thor my. cli:hello --from "Carl Lerche" Kelby 这 里 的 --from) 


public task & public command 
定义 一 个 实例 方法 ， 方 法 内 容 就 是 其 父 类 的 私有 方法 。 


public command :foo 


Thor 


What Is Thor 
Thor Wiki 
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generators 下 的 目录 、 文 件 
对 于 Generator, Rails 是 自 产 (定义 ) 和 自 销 ( 自 销 )， 还 对 外 提供 接口 ， 供 我 们 使 用 。 
全 部 的 文件 及 目录 : 


# 目录 
css/ 

erb/ 
js/assets/ 
rails/ 
test_unit/ 


# 文件 

actions.rb 

active model.rb 
app. base.rb 
base.rb 

erb.rb 

generated attribute.rb 
migration.rb 

model helpers.rb 
named base.rb 
resouce helpers.rb 
test case.rb 

test unit.rb 


# 目录 


actions/ 
testing/ 


重要 的 类 : 


Base、Named Base 以 及 App Base. 


自己 调用 自己 : 


其 中 ， 除 actions/ 和 testing/ 外 的 其 它 5 个 目录 为 调用 。 


css/ 

erb/ 
js/assets/ 
rails/ 
test_unit/ 


我 们 在 写 自 己 的 脚本 时 ， 可 以 参考 。 
方法 、 别 名 、 选 项 默认 值 
api only! 
fallbacks 
help 
hidden namespaces & hide namespace & hide namespaces 
invoke 
levenshtein distance 
no color! 
print generators 
public namespaces 
sorted groups 


subclasses 


别名 : 


DEFAULT ALIASES - ( 
rails: ( 

actions: '-a', 
orm: '-o', 
javascripts: '-j', 
javascript engine: '-je', 
resource controller: '-c', 
scaffold controller: '-c', 
stylesheets: '-y', 
stylesheet engine: '-se', 
scaffold stylesheet: '-ss', 
template engine: '-e', 
test framework: '-t' 


test unit: { 
fixture replacement: '-r', 


选项 默认 值 : 


DEFAULT OPTIONS - ( 
rails: { 
api: false, 
assets: true, 
force plural: false, 
helper: true, 
integration tool: nil, 
javascripts: true, 
javascript engine: :js, 
orm: false, 
resource controller: :controller, 
resource route: true, 
scaffold controller: :scaffold controller, 
stylesheets: true, 
stylesheet engine: :css, 
scaffold stylesheet: true, 
test framework: false, 
template engine: :erb 


Base 


继承 于 Thor::Group 并 include Rails::Generators::Actions 
类 方法 

base root 

default source root 

desc 

hide! 

namespace 

remove hook for 

hook for 


source root 


class option 


source root generator 示例 模板 文件 (templates) 所 在 位 置 。 


人 在 templates 


source root File.expand path("../templates", _ FILE ) 


hook for 触发 其 它 的 generator > VA --option 的 形式 提供 。 


desc 终端 里 使 用 对 应 命令 获取 帮助 ( 即 --help) 会 在 最 后 显示 此 内 容 。 


其 它 类 方法 


add shebang option! 
banner 
base name 


default aliases for option 
default for option 
default generator root 


default value for option 


generator name 
usage path 


实例 方法 


extract last module 


filename with extensions 


Actions 
主要 是 生成 指定 类 型 的 文件 ， 或 给 已 有 文件 添加 内 容 。 
include by Base. 
实例 方法 
add_source 
after_bundle 
environment & application 
capify! 


gem 
gem group 


generate 
git 
initializer 
lib 

rake 
rakefile 
readme 
route 


vendor 


被 Migration 调用 ， 但 应 该 不 能 直接 使 用 。 
include by Migration. 
实例 方法 

existing migration 


exists? 
identical? 


migration dir 
migration file name 


relative existing migration 


revoke! 


on conflict behavior 


say status 


Named Base 
继承 于 Base. 
默认 rails g generator 生成 的 就 是 继承 于 它 。 
check class collision 
template 
application name 
attributes names 


class name 
class path 


file path 
human name 
i18n scope 


indent 

index helper 
inside template 
inside template? 


module namespacing 


namespace 
namespaced? 
namespaced class path 
namespaced file path 
namespaced path 


plural file name 
plural name 


plural table name 
pluralize table names? 


regular class path 
route url 


singular name 
singular table name 


table name 
uncountable? 


wrap with namespace 


check class collision 举例 rails generate controller NAME [action action] 
[options] 检测 这 里 的 NAME 是 否 已 经 被 使 用 ， 也 就 是 说 是 否 有 冲突 。( 因 为 后 续 会 
创建 新 的 文件 ， 如 果 冲 突 的 话 ， 之 前 的 文件 及 内 容 会 被 覆盖 ) 


attr reader :file name 


HE 


AN 


在 外 面 ， 只 要 直接 或 间接 add_ dependency "railties"， 即 可 使 用 ， 因 为 它 属 于 这 个 
(而 不 是 rails) 


- 继承 于 NamedBase 或 Base 
这 是 最 常见 的 用 法 。 
- 直接 使 用 某 个 模块 


当然 你 也 可 以 更 进一步 ， 继 承 于 其 它 模块 ， 但 因为 没有 API 和 文档 ， 使 用 门槛 提高 
不 少 。 


e 目的 很 明确 
e 非常 确定 这 个 模块 干 的 是 什么 
举例 : 


Erb::Generators::ControllerGenerator 


require 'rails/generators/erb/controller/controller generator' 


module Haml 
module Generators 
class ControllerGenerator « Erb::Generators::ControllerGener 
ator 
source root File.expand path("../templates", _ FILE ) 


protected 


def handler 
:haml 
end 
end 


生成 过 程 中 的 一 些 属性 判断 。 


Erb-Generators-Base 


继承 于 Rails::Generators::NamedBase 


formats 
format 
handler 


filename with extensions 


App-Base 


继承 于 Base. 


针对 Rails 本 身 提 供 了 大 量 方便 使 用 的 方法 。 注 意 ， 它 们 不 具备 通用 性 。 更 多 信 
息 ， 可 以 查看 源 代码 ， 这 里 就 不 列 出 了 。 


rails new APP PATH [options] 
创建 新 Rails 应 用 的 时 候 ， 它 会 派 上 大 用 场 。 
rails plugin new APP PATH [options] 
创建 新 engine 的 时 候 ， 也 会 派 上 大 用 场 。 
Gemfile-Entry 


github 
new 
path 
version 


上 面 的 方法 都 不 能 直接 使 用 。 


Generators 文件 下 的 内 容 
类 方法 : 

invoke 

fallbacks # 添加 fallback 

help # 输出 帮助 信息 

no color! # 在 终端 里 输出 没有 颜色 


subclasses # generators FR 
public namespaces 


hidden namespaces 
hide namespaces & hide namespace 


print generators 


sorted groups 


invoke 授 受 namespace, arguments 和 behavior > % 7 generate, destroy 和 
update 等 命令 的 入 口 。 


fallbacks 使 用 举例 : 
Rails::Generators.fallbacks[:shoulda] = :test unit 
其 它 类 方法 : 


levenshtein distance 


DEFAULT ALIASES - ( 
rails: ( 

actions: '-a', 
orm: '-o', 
javascripts: '-j', 
javascript engine: '-je', 
resource controller: '-c', 
scaffold controller: '-c', 
stylesheets: '-y', 
stylesheet engine: '-se', 
template engine: '-e', 
test framework: '-t' 


ty 


test_unit: { 
fixture replacement: '-r', 


DEFAULT OPTIONS - ( 
rails: { 
assets: true, 
force_plural: false, 
helper: true, 
integration_tool: nil, 
javascripts: true, 
javascript engine: :js, 
orm: false, 
resource controller: :controller, 
resource route: true, 
scaffold controller: :scaffold controller, 
stylesheets: true, 
stylesheet engine: :css, 
test framework: false, 
template engine: :erb 


RAILS DEV PATH 
ame( FILE )) 
RESERVED. NAMES 


File.expand path("..7..7..7/..7:.7..", File.dirn 


%w[application destroy plugin runner test] 


Migration 

require 'actions/create migration' 
create migration 
migration template 


set migration assigns! 


migration template #7 template ` copy. file 类 似 ， 复 制 模板 生成 新 的 文件 。 但 
不 同 点 在 于 ， 这 里 新 生成 的 文件 会 自动 加 上 时 间 改 。 


Active Model 


功能 是 : 定制 Controller 里 默认 的 代码 。 它 只 是 接口 ， 具 体 让 各 个 ORM 实现 。 
included by ResourceHelpers & ModelHelpers 


类 方法 : 


all 
build 
find 
new 


实例 方法 : 


destroy 
errors 
save 
update 


Resource Helpers 


从 Named Base 里 拆 分 而 来 。 


rails generate resource 
rails generate scaffold 


rails generate scaffold controller 


方法 : 
attr reader :controller name, :controller file name 


fe : 


controller class path 
controller file path 

controller class name 
controller ii18n scope 


orm class 
orm instance 


assign controller names! 


Model-Helpers 


为 生成 起 辅助 作用 。 


rails generate model 


field type 


default 


plural name 
singular name 


human name 

index name 
column name 
foreign key? 
reference? 
polymorphic? 
required? 

has index? 

has uniq index? 
password digest? 
token? 

inject options 
inject index options 


options for migration 


Generated Attribute 
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Rails 里 所 有 的 配置 项 


链接 Configuring Rails Applications 


配置 项 ， 除 了 Configuration 对 象 外 ， 还 可 以 由 class attribute 进行 设置 。 
前 者 相当 于 只 有 一 个 总 开关 ， 只 能 决定 开 或 关 。 而 后 者 除了 总 开关 外 ， 还 可 以 有 分 
开关 ， 总 开关 设置 状态 后 ， 可 以 不 设置 状态 (继承 ) ， 或 者 设置 自己 的 状态 。 


附录 ， 查 看 各 个 Railtie 所 带 配置 项 : 


railties = ['action mailer', 'active record', 'action controller' 
, 

tactron-dispatch "actionzview', "active support ^, Heni 23 
ssets'] 


railties.each do |railtie| 
p railtie.camelize 


klasses - Rails.configuration.send(railtie).values.map(&:class 
).uniq 


klasses.each do |klass| 
p klass 


Rails.configuration.send(railtie).each pair do |k,v| 
p k if v.class -- klass 
end 


一 般 常 用 配置 项 


# 自动 加 载 目 录 
config.autoload paths 

# 立即 加 载 目录 
config.eager load paths 


# 立即 加 载 开 关 。 开 发 环境 false’ £7 We true 
# eager load 始终 是 立即 加 载 ， 它 只 影响 autoload 配置 
config.eager load 


# 每 次 HTTP 请 求 之 间 ， 是 否 重 新 加 载 环境 (类 、 模 块 ) 
# 是 ， 则 类 似 load; 否 ， 则 类 似 require 

# 影响 控制 台 里 的 reload! 效果 

config.cache classes 


n 


# 缓存 存储 方式 
config.cache store 


config.console 

config.disable dependency loading 
config.encoding 
config.exceptions app 

config.file watcher 


# 网 站 是 否 强 制 启 用 https 
config.force ssl 


# log BARE 
config.log_formatter 
# debug > it info 
config.log_level 


config.logger 


config.middleware 


config.reload classes only on change 


secrets.secret key base 


# 请 使 用 `public file server.enabled' 
config.serve static files 


# session 存储 方式 及 限制 条 件 
config.session store 


# HR» RUA UTC 
config.time_zone 


Action Mailer 


FalseClass 


:raise delivery errors 


String 


assets dir 
:javascripts dir 
:stylesheets dir 
: preview path 


TrueClass 


:show previews 


NilClass 


:asset host 
:relative url root 


config. 


config. 


config. 


config. 


config. 


config. 


config. 


config. 


action mailer. 


action mailer. 


action mailer. 


action mailer. 


action mailer. 


action mailer. 


action mailer. 


action mailer. 


logger 


smtp settings 


sendmail settings 


delivery method 


perform deliveries 


default options 


observers 


interceptors 


Active Record 


TrueClass 


maintain test schema 
:belongs to required by default 


config.active record.logger 
config.active record.primary key prefix type 


config.active record.table name prefix 
config.active record.table name suffix 


config.active record.schema migrations table name 
config.active record.pluralize table names 
config.active record.default timezone 
config.active record.schema format 

config.active record.timestamped migrations 
config.active record.lock optimistically 
config.active record.cache timestamp format 
config.active record.record timestamps 
config.active record.partial writes 


config.active record.dump schema after migration 


Active Record 
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Action Controller 


FalseClass 


Fragment 


:perform_caching 


String 


:assets dir 
: javascripts dir 
:stylesheets dir 


ActiveSupport::Logger 


: Logger 


ActiveSupport::Cache::NullStore 


:cache store 


NilClass 


:asset host 
:relative url root 


TrueClass 


:forgery protection origin check 


Helne! 
ne CI 


: include all helpers 


per form csrf tokens 





.action controller. 


.action controller. 


.action controller. 


.action controller. 


.action controller. 


.action controller. 


.action controller. 


.action controller. 


.action controller. 


asset host 


default static extension 


default charset 


logger 


request forgery protection token 


allow forgery protection 


permit all parameters 


action on unpermitted parameters 


always permitted parameters 


Action Dispatch 


config.filter parameters 
config.filter redirect 


config.consider all requests local 


NilClass 


:X sendfile header 
:default charset 


TrueClass 


:ip spoofing check 

: show exceptions 
:perform deep munge 
:always write cookie 


FalseClass 


:ignore accept header 
:rack cache 


Fixnum 


:tld length 


Hash 


:rescue templates 
'rescue responses 
:default headers 


String 


:http auth salt 

:signed cookie salt 
:encrypted cookie salt 
:encrypted signed cookie salt 


Symbol 


:cookies serializer 


Action View 


TrueClass 


:debug missing translation 


config. 


.action view. 


.action view. 


.action view. 


.action view. 


.action view. 


.action view. 


.action view. 


rarha nlac 
‚AULIIC clas 


action view. 


field error proc provides 


default form builder 


logger 


erb trim mode 


embed authenticity token in remote forms 





prefix partial path with controller namespace 


raise on missing translations 


ses 


cache template loading 


Active Support 


Symbol 


: deprecation 


config.active support. 


config.active support. 


config.active support. 


config.active support. 


config.active support. 


bare 


test order 


escape html entities in json 


use standard json time format 





time precision 
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Array 


:railties load path 
: load path 


config.ii18n.available locales 
config.ii8n.default locale 


config.ii18n.enforce available locales 


Generators 
config.generators 
assets 
force plural 
helper 
integration tool 
javascripts 
javascript engine 
orm 
resource controller 
scaffold controller 
stylesheets 
stylesheet engine 
test framework 


template engine 


Assets 


Array 


: blocks 

: paths 
:precompile 
:resolve_with 


String 


: prefix 
: version 


NilClass 


:manifest 


TrueClass 
: debug 
:compile 


:digest 
:raise_runtime_errors 


Fixnum 


:cache limit 


# 配置 静态 资源 所 在 网 址 。 我 们 网 站 所 用 的 静态 资源 可 以 单独 存放 
# CDN、 网 站 对 静态 资源 访问 (BA) 比较 大 的 时 候 可 以 考虑 
config.asset host 


# 是 否 使 用 Assets Pipeline, RUA true 
config.assets.enabled 


config.assets.compress 


config.assets.css compressor 
# de: config.assets.css compressor = :yui 


config.assets.js compressor 
# ® :config.assets.js compressor = :uglifier 


config.assets.cache store 


config.assets.logger 


Environments 


config.cache classes - true 
config.eager load - true 
config.consider all requests local = false 


config.public file server.enabled - ENV['RAILS SERVE STATIC FILE 
S'].present? 


config.log level - :debug 


config.log formatter - ::Logger::Formatter.new 


ache classes = false 每 一 次 HTTP 请 求 之 间 ， 都 会 重新 加 载 代 码 ， 类 似 于 load F 
法 。 而 设置 为 true 后 ， 则 只 会 在 第 一 次 加 载 ， 后 续 不 加 载 ， 相 当 于 require. 


Rails.configuration.instance variables 


# trails, :active record, :test unit 3 
:Qgenerators, 


LL IE Al 4A db 121 44 
# 用 到 的 中 间 件 


TE 17 


:@middleware, 


:@encoding, 


Jui ALLEN 
# LU VT jT AL A 


:@allow_concurrency, 


:Qconsider all requests local, 


# 日 志 里 过 滤 什 么 参数 


:@filter_parameters, 


# 日 志 里 重 定向 过 滤 
:@filter_redirect, 


# 辅助 文件 所 在 路 径 
:Qhelpers paths, 


# 新 项 目 黑 认 首 页 ， 是 否 使 用 、 使 用 哪个 页 面 
:Qpublic file server, 


# 强制 https 链接 
:Qforce ssl, 


# https 链接 参数 
:Qssl options, 


4 怎么 存储 session 
:Qsession store, 


4 session 相关 参数 
:Qsession options, 


# 时 区 格式 。 黑 认 用 UTC 
:Qtime zone, 


# 每 周 开始 时 间 。 默 认 是 周一 ， 比 如 有 的 是 周 日 
:Qbeginning of week, 


# 日 志 
:@log_level, 


# 缓存 怎么 存 、 放 在 哪 ? 


:Qcache store, 


4 EA all 
:Qrailties order, 


:Qrelative url root, 


# 即使 是 开发 环境 ， 也 应 该 只 重新 加 载 更 改过 的 代码 
:Qreload classes only on change, 


# 文件 更 改 检测 
:Qfile watcher, 


:Qexceptions app, 


# 默认 true 
:Qautoflush log, 


# RU Formatter 


:@log_formatter, 


# XXX true 


:Qeager load, 


# 默认 没有 
:Qsecret token, 


# 默认 没有 


:Qsecret key base, 


# TAM Rails API 
:Qapi only, 


# 默认 default 
:@debug_exception_response_format, 


# 自己 配置 的 ， 可 以 用 这 
:@x， 


:@paths, 


# 自动 加 载 
:@autoload_paths, 


# 延迟 加 载 


:Qeager load paths, 


# 自动 加 载 一 次 
:Q@autoload once paths, 


# 缓存 类 (代码) 


:Qcache classes] 


设置 项 补充 


H 框架 初始 化 后 ， 运 行 这 里 的 任务 
config.after initialize takes 


# 它 里 面 所 包含 的 namespace 都 会 被 立即 加 载 
config.eager load namespaces 


# fe autoload paths 区 别 在 于 : 开发 环境 下 ， 每 一 次 请 求 之 间 ， 它 不 会 被 更 新 了 
# 使 用 它 的 目录 ， 必 须 同时 使 用 autoload paths 
config.autoload once paths 


# 如 果 你 想 把 周 日 当做 第 一 天 ， 那 也 可 以 
config.beginning of week 


# dTÁRHE Xu E 


config.colorize logging 


# 给 log 打 标 签 
# 子 域名 或 多 服务 器 时 可 考虑 
config.log tags 


Middleware 
通过 config.middleware 有 什么 方法 可 用 ? 
44 [Configuration Middleware Stack Proxy] 


有 什么 middleware 可 供 选 择 ? 
参考 【Action Dispatch Middleware] 


一 些 有 意思 的 点 ， 或 者 语法 糖 ， 或 者 对 于 新 手 来 说 是 "魔术 "。 


继承 心得 


C<B<A 人 A 有 时 候 之 所 以 B X extend A 并 不 是 为 了 B 自己 使 用 ， 而 仅仅 是 为 了 方 
便 C 


继承 关系 及 ancestors 


父 类 和 模块 都 有 此 方法 ， 子 类 没有 ( 重 写 ) 此 方法 ， 执 行 顺 序 : 模块 按 被 加 载 的 顺序 
逆序 ， 最 后 到 父 类 。 


module A 
def do something 
puts 'A -» do something' 
super 
end 
end 


module B 
def do something 
puts 'B -» do something' 
super 
end 
end 


module C 
def do something 
puts 'C -» do something' 
super 
end 
end 


class Parent 
def do something 
puts 'Parent -> do something' 
end 
end 


"m ^g 
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class Child < Parent 
include A 
include B 
include C 

end 


p Child.ancestors 
# => [Child, C, B, A, Parent, Object, Kernel, BasicObject ] 


Child.new.do something 
输出 => 


C -» do something 
B -» do something 


# 
# 
# 
# 
# A -> do_something 
# 


Parent -> do_something 


Note: 以 上 参考 modules.rb 


inherited 方法 
inherited(subclass) 
当前 类 定义 子 类 时 ， 就 会 触发 此 回调 。 (X44 Module.html#included) 
举例 : 
class Foo 
def self.inherited(subclass) 
puts "New subclass: #{subclass}" 


end 
end 


class Bar « Foo 
end 


class Baz « Bar 
end 


New subclass: Bar 
New subclass: Baz 


另 : 继承 于 一 个 类 ， 父 类 的 类 方法 就 是 子 类 的 类 方法 ， 父 类 的 实例 方法 就 是 子 类 的 
实例 方法 。 


extend 方法 


这 里 专 指 : 一 个 对 象 继承 一 个 模块 。 作 用 是 : 给 一 个 对 象 添加 实例 方法 (会 覆盖 原 有 
dX): 


module Mod 
def hello 
"Hello from Mod. \n" 
end 
end 


class Klass 
def hello 
"Hello from Klass.\n" 
end 
end 


k - Klass.new 


k.hello #=> "Hello from Klass.\n" 
k.extend(Mod) #=> #<Klass:0x401b3bc8> 
k. hello #=> "Hello from Mod. \n" 


ActiveSupport::Cache 里 就 用 这 种 方式 给 Store 实例 对 象 添 加 了 Local Cache 相关 
方法 。 


Rails 源 代 码 里 一 些 常用 方法 


Active Support 


eager_autoload 和 autoload 


class attribute 


定义 一 个 类 属性 ， 子 类 继承 于 父 类 。 
子 类 可 以 更 改 自己 的 属性 ， 但 不 影响 到 父 类 的 。 


attr internal 


alias method :attr internal, :attr internal accessor 


mattr accessor 

alias :cattr accessor :mattr accessor 

定义 一 个 类 属性 ， 同 时 具备 类 和 实例 级 别 的 读 、 写 。( 这 里 类 似 全 局 变量 了 ) 
delegate 

委托 ， 将 它 人 的 方法 做 为 已 用 。 
后 面 是 个 对 象 即 可 ， 而 Ruby LF fe" da ow Ane 


最 终 通 过 module eval 并 重新 定义 了 方法 。 


委托 类 方法 给 实例 对 象 使 用 。 


class Foo 
def self.hello 
"world" 
end 


delegate :hello, to: :class 
end 


Foo.new.hello # => "world" 
config_accessor 


定义 一 个 属性 ， 同 时 具备 类 和 实例 级 别 的 读 、 写 。 
实例 可 以 更 改 自己 的 属性 ， 但 不 影响 到 类 的 。 


define callbacks 


定义 回调 。 


run_callbacks 


运行 回调 。 


attr internal writer 


功能 类 似 attr_writer， 但 内 部 实现 有 一 点 不 同 。 


info debug warn error fatal unknown 也 就 是 Rails.logger 的 各 个 
级 别 (或 者 说 类 别 )。 


included 


指 的 是 ActiveSupport::Concern 所 提供 的 实例 方法 。 
当 此 模块 被 include 时， 执行 什么 代码 。 


extract options! 


把 可 选 参数 里 的 Hash 部 分 ， 革 取出 来 。 


Abstract Controller 


abstract! 


声明 此 Controller 是 抽象 的 。 


ActionController::Metal 和 ActionController::Base 都 声明 为 抽象 的 。( 
作用 参考 下 面 解释 ) 


我 们 自 定 义 的 Controller 里 的 public instance methods( 公 开 实 例 方 法 ) 都 会 被 当做 
action 来 对 待 。 因此， 继承 的 时 候 要 做 一 些 处 理 ， 以 避免 父 类 的 实例 方法 被 当做 
action. 目前 ， 解 决 方法 是 把 父 类 声明 为 : abstract = true 


helper 
引入 外 部 模块 ( 专 指 helper 模块 )， 功 能 类 似 include. 


helper_method 


将 Controller 里 的 方法 转化 为 helper 方法 。 


Railtie 


delegate :config , to: :instance 


Initializable 


initializer 


Rails assets precompile 


概述 


Assets Pipeline 主要 功能 & 特性 

合并 、 压 缩 、 解 析 css, js 文件 。 

合并 : 将 多 个 js 或 css 文件 压缩 打包 成 单一 文件 ， 减 少 http request 的 大 小 与 数 
压缩 : 可 以 去 除 空格 、 注 释 等 。 

解析 : 你 可 直接 使 用 SCSS 和 CoffeeScript, 它们 会 被 解析 成 css 和 js. 

主要 通过 Sprockets 完成 


Assets Pipeline 的 功能 主要 由 重要 的 组 件 Sprockets 完成 。 
Sprockets 用 来 从 你 的 assets 路 径 打 包 压 缩 你 所 有 的 assets 后 包装 成 一 个 文件 ， 


然后 放 到 你 目的 地 路 径 (public/assets). 
通过 它 可 以 对 css, js 等 静态 资源 进行 编译 、 压 缩 。 
全 令 行 取消 ， 不 使 用 它 : 


A 


a=) 


rails new appname --skip-sprockets 


这 会 使 得 原来 的 : 


require 'rails/all' 


require "rails" 

4 Pick the frameworks you want: 

require "active model/railtie" 

require "active job/railtie" 

require "active record/railtie" 

require "action controller/railtie" 

require "action mailer/railtie" 

require "action view/railtie" 

# require "sprockets/railtie" # <- 重点 是 这 行 
require "rails/test unit/railtie" 


sprockets 已 经 被 取消 掉 。 
并 且 ， 原 来 的 : 
gem 'sass-rails' 


gem 'uglifier' 
gem 'coffee-rails' 


RR: 
gem 'coffee-rails', '-> 4.1.0' 


默认 的 3 个 存放 静态 资源 的 地 方 


默认 3 路 径 : 

app/assets 放置 我 们 自己 所 写 的 js、css 或 images, 并 且 它 们 和 业务 关联 比较 紧 

密 。 实 际 上 ， 这 种 形式 用 得 最 多 。 

lib/assets 放置 我 们 抽取 出 来 的 assets, 一 般 来 说 这 样 的 代码 比较 通用 。 实 际 上 ， 这 
种 形式 用 得 最 少 。 

vendor/assets 是 放 一 些 我 们 从 第 三 方 引 进 的 assets， 例 如 一 些 jQuery 插件 。 


开发 环境 ， 你 可 以 把 你 的 rails app 跑 起 来 后 ， 从 HTML 源 代 码 里 查看 引入 了 那些 
样式 或 脚本 ， 进 而 修改 ， 很 方便 。 


这 3 个 目录 ， 看 似 是 分 开 的 。 但 生产 环境 下 ， 它 们 后 会 被 编译 、 打 包 在 一 起 ， 也 就 
是 说 ， 它 们 其 实 是 连通 的 。 


.erb 使 用 Asset Helper 方法 


为 Sprockets-rails 已 经 引入 了 以 下 两 个 模块 


include ActionView::Helpers::AssetUrlHelper 
include ActionView::Helpers::AssetTagHelper 


所 以 ， 在 *css.erb 文件 里 ， 你 都 可 以 使 用 以 下 方法 : 


stylesheet link tag 
javascript include tag 


image tag 


asset path 
asset data uri 


同样 的 ， 使 用 js.erb 后 级 之 后 可 以 用 asset path 等 方法 。 


使 用 举例 : 


/audios/horse.wav 


dk 
ll 
V 


audio path("horse.wav") 
audio tag("sound") 4 -» «audio srcz"/audios/sound" /» 


font path "font: tlh” ) # => /fonts/font.ttf 


image path("edit.png") # => "/images/edit.png" 

image_tag("icon.png") # => <img src="/images/icon.png" alt="I 

Conde» 

video path("hd.avi") # => /videos/hd.avi 

video_tag("trailer.ogg") # => <video src="/videos/trailer.ogg" /> 
Ki EH 

















sass-rails 提供 的 几 个 Asset Helper 方法 


由 sass-rails 提供 几 个 以 -url 和 -path 结尾 的 Asset Helpers 方法 及 结果 : 


image-url("rails.png") # => url(/assets/rails.png) 
image-path("rails.png") # => "/assets/rails.png". 


asset-url("rails.png") # => url(/assets/rails.png) 
asset-path("rails.png") # => "/assets/rails.png" 


asset-data-url("rails.png") # => url(data: image/png; base64, iVBOR 
wOK...) 


注意 ， 你 可 以 同时 使 用 sass-rails 提供 的 -url 及 原生 的 url 方法 ;使 用 - 
url 时 参数 带 引 号 ， 使 用 url 时 参数 不 带 引 号 。 


Sprockets 提供 require 等 指令 
require 4 引入 某 个 文件 。 如果 有 重复 引入 ， 它 会 自动 忽略 ， 只 引入 一 次 。 


require directory # 引入 某 个 目录 下 的 文件 ， 不 会 递归 其 子 目 录 。 
require tree 4 引入 某 个 目录 及 递归 其 子 目 录 下 的 所 有 文件 ， 默 认 指 的 是 当前 目录 。 


require self 4 引入 在 自己 文件 里 写 的 样式 或 脚本 。 
link 


depend on 
depend on asset 


stub 
Ee | 
上 述 几 个 方法 ， 由 Sprockets-rails 提供 。 


但 上 述 几 个 方法 ， 不 要 在 SASS/SCSS 文件 里 使 用 ， 而 是 使 用 sass-rails 提供 的 
@import 方法 。 


根据 后 级 名 ， 决 定编 译 顺 序 


注意 后 缓 名 的 顺序 : 


app/assets/javascripts/projects.js.erb.coffee 


从 右 到 左 一 个 个 解析 的 。 
生产 环境 ， 需 要 注意 的 点 


1) Precompiling Assets 


RAILS ENV-production bin/rake assets:precompile 


load 'deploy/assets' 


另 ， 上 述 会 生成 、 使 用 shared/assets 目录 。 
预 编 译 的 文件 ， 默 认 是 : 
[ Proc.new { |filename, path| path =~ /app\/assets/ && !%w(.js . 


css).include?(File.extname(filename)) ), 
/application.(css|js)$/ ] 


新 增 : 


Rails.application.config.assets.precompile += ['admin.js', 'admi 
n.css', 'swfObject.js'] 

另 ， 只 使 用 js 或 .css 后 缓 即 可 。 不 必 减 少 ， 也 不 必 增 多 。 

2) Far-future Expires Header 


配置 Web 服务 器 ， 更 好 的 对 待 静态 资源 : 


location - ^/assets/ ( 
expires 1y; 
add header Cache-Control public; 


add header ETag ""; 
break; 


CDN AH Hr A TR 


把 静态 资源 放 到 其 它 服务 器 : 


config.action controller.asset host = 'mycdnsubdomain.fictional- 
cdn.com' 


config.action controller.asset host - ENV['CDN HOST'] 


<%= asset path('smile.png') 96» 
http://mycdnsubdomain.fictional-cdn.com/assets/smile.png 


# 仅 作用 于 指定 的 静态 资源 
<%= asset path 'image.png', host: 'mycdnsubdomain.fictional-cdn. 
com' 96» 


另 ， 如 果 生 产 环 境 有 图 片 ， 而 开发 环境 没有 ， 而 自己 又 不 想 导 图 片 。 可 以 党 试用 这 
种 方式 ， 在 开发 环境 也 显示 图 片 。 


两 种 引入 方式 


1) 独立 引入 


config.assets.precompile += %w( site.css ) 


stylesheet link tag "site" 


2) vx 
4 application.css 


// - require self 
// - require 'site' 


当然 了 ， 也 可 以 直接 把 文件 放 到 public/assets/ 目录 下 ， 之 后 这 些 文件 不 受 Assets 
precompile 影响 。 


sprockets-rails 
Railtie 


VA Railtie 的 形式 引入 ， 继 承 于 Rails::Railtie (PA > Rails::Railtie 提供 的 方法 ， 它 
是 可 以 用 的 ) 


主要 任务 包括 ， 但 不 限于 : 


e iX config.assets.x (这 里 的 X 表 示众 多 的 配置 项 ) 
e 其 它 众 多 看 不 见 的 功能 


上 述 配置 ， 包 括 但 不 限于 : 


config.assets.precompile 
config.assets.paths 
config.assets.version 
config.assets.prefix 
config.assets.manifest 
config.assets.digest 
config.assets.debug 
config.assets.compile 
config.assets.configure 


打开 了 Rails 下 的 Engine % Application 


Engine 主要 是 加 入 路 径 : 


paths["vendor/assets"] 
paths["lib/assets"] 


paths ["app"] 
paths["app/assets" ] 


Application 主要 提供 以 下 几 个 config 项 : 
:assets 


:assets manifest 
:precompiled assets 


如 何 引入 
它 是 gem， 所 以 : 
gem 'sprockets-rails', :require -» 'sprockets/railtie' 
Rake task 
由 Task 文件 完成 。 


rake assets:precompile 
rake assets:clean 
rake assets:clobber 


> 


iz 


RAILS_ENV=production bin/rake assets:precompile 


将 app/assets 存放 普通 的 前 端 资源 复制 到 public/assets A 3k > 
Helper 


包括 但 不 限于 : 


include ActionView::Helpers::AssetUrlHelper 
include ActionView::Helpers::AssetTagHelper 
include Sprockets::Rails::Utils 


VIEW ACCESSORS - [:assets environment, :assets manifest, 


:assets precompile, :precompiled assets, 
:assets prefix, :digest assets, :debug assets] 


一 些 配置 项 
rails scaffold 或 rails g controller 时 不 再 生成 默认 的 js, css 文件 


config.generators do |g| 
g.assets false 
end 


a 


显 性 配置 css, js 压缩 器 


config.assets.css compressor = :yui 
config.assets.js compressor = :uglifier 
config.assets.css compressor - :yui 
config.assets.css compressor - :sass 


JavaScript Compression 
:closure, :uglifier 和 :yui 
分 别 对 应 


closure-compiler, uglifier 和 yui-compressor gem. 


config.assets.js compressor - :uglifier 


seo fe, BIE AP A HEIR TE : 


如 何 新 增 : 


config.assets.paths << Rails.root.join("lib", "videoplayer", "fl 
ash") 


Runtime Error Checking 
config.assets.raise runtime errors - false 

没 必要 关 掉 吧 。 

Turning Debugging Off 
config.assets.debug = false 

ALP RIPE o 

Live Compilation 

生产 环境 ， 实 时 编译 。 


开发 、 测 试 等 环境 ， 由 coffee-script and sass 实时 编译 。 


反正 我 是 不 推荐 : 


config.assets.compile = true 


生产 环境 app/assets 下 的 文件 已 经 预 编译 好 ， 放 到 了 public/assets 下 ， 直 接 使 用 
即 可 。 


CDNs and the Cache-Control Header 


config.static cache control = "public, max-age-31536000" 


Changing the assets Path 


config.assets.prefix - "/some other path" 


这 也 没 必 要 吧 “。 


Assets Cache Store 


config.assets.cache store = :memory store 
config.assets.cache store = :memory store, { size: 32.megabytes 
} 


config.assets.configure do |env| 
env.cache = ActiveSupport::Cache.lookup store(:null store) 
end 


一 般 情况 下 ， 也 不 会 动 这 里 哈 ~ 
ssets Pipeline 怎么 关 掉 ? 


你 可 以 在 confing/application.rb P 4e4& X 4$ : 


config.assets.enabled = false 


其 它 
查看 所 有 assets 目录 


当 使 用 第 三 方 gem 引入 assets 资源 的 时 候 ， 使 用 它 可 以 让 我 们 看 到 加 入 了 哪些 目 
录 o 


Rails.application.config.assets 


Note: 它 只 管 加 载 目 录 ， 想 引入 目录 下 面 资源 文件 的 话 ， 还 得 自己 或 gem ik 
jm © 


Deploy 的 小 技巧 

1) 本 地 编译 - 有 好 也 有 坏 。 反 正 我 是 不 推荐 。 
2) 如 果 assets 没有 更 新 ， 就 不 要 跑 precompile. 
3) 有 更 新 就 在 本 地 precompile， 然 后 再 上 传 。 
惯用 require tree 


# application.css 
//= require tree 


4 相当 于 
//= require tree . 


意味 着 加 载 当 前 目录 下 的 文件 ， 并 且 递 中 加 载 其 子 目录 下 的 文件 。 虽 然 省 事 了 ， 这 
并 不 是 好 的 实践 。 因 为 我 们 的 文件 、 目 录 是 会 逐渐 增 儿 的。 这 就 容易 出 现下 列 结 
RK: 


e 加载 
e 加载 


， 导 致 性 能 慢 


过 
过 多 ， 导 致 混淆 (原本 没有 必要 加 载 的 文件 也 加 载 了 ) 


NN ON 


css & scss & sass 


后 组 名 .scss 意义 Sassy CSS 
(还 有 一 种 后 组 名 为 sass 的 ， 区 别 是 它 严格 缩 进 ) 


根据 原 有 文件 后 级 名 ， 选 择 不 同 的 使 用 方式 : 


# 1 application.css 
*= require font-awesome 


4 2 application.css.scss 


Qimport "font-awesome"; 


# 3 application.css.sass 


Qimport font-awesome 


Sil assets 是 否 挂 了 (BE) 的 命令 


A "rails.png" # & 


Rails.application.assets.find_asset 'rails.png' 

=> #<Sprockets: :StaticAsset : 0x3fed3aa004f8 
pathname="/Users/kelby/appname/app/assets/images/rails.png", 
mtime=2015-04-13 20:10:42 +0800, digest-'3526faaei1dacebb591431f0 
054e8f33e'» 


图 片 "not-image.png" 不 存在 


Rails.application.assets.find asset 'not-image.png' 
=> nil 


没有 JavaScript 运行 时 


group :production do 
gem 'therubyracer' 
end 


但 不 推荐 这 么 做 ， 还 是 安装 的 好 。 
X-Sendfile Headers 


Web 服务 器 支持 的 话 ， 不 妨 一 试 : 


4 config.action dispatch.x sendfile header = "X-Sendfile" # for 
Apache 

4 config.action dispatch.x sendfile header = 'X-Accel-Redirect' 
# for NGINX 


当 你 使 用 send file 等 方法 给 bia de 如 果 你 开启 了 此 特性 ， 并 且 
硬盘 里 有 恰好 又 有 此 文件 。 那 么 ， 你 的 Web 服 务 器 会 忽略 应 用 的 响应 数据 ， 直 接 从 
硬盘 读 取 文 件 并 返回 ， 使 得 速度 更 快 。 


不 好 的 实践 


以 controller 为 单位 加 载 资 源 


<%= javascript include tag params[:controller] %> 
<%= stylesheet link tag params[:controller] 96» 


在 我 看 来 ， 上 述 方式 并 不 好 。 
CSS 里 引入 图 片 、 字 体 需 注意 


使 用 css， 特 别 是 第 三 方 样式 的 时 候 ， 注 意 查看 是 否 引入 了 图 片 、 字 体 ， 它 们 使 用 
url 引用 ， 以 及 路 径 是 否 准 确 。 


Debug 


Rails.application.config.assets 


查看 资源 情况 。 


它 属于 : 


Rails.application.config.assets.class 
-» Sprockets::Railtie::OrderedOptions 


我 们 接触 比较 多 的 是 其 中 的 paths 和 precompile 对 应 的 数据 。 


Turbolinks 产生 的 原 


原因 : 


1. HTML 5 引进 了 "History interface" 
2. 原来 的 一 个 request/response 需要 传递 整个 页 面 (不 论 你 有 没有 做 缓存 ) 
3. Assets Precompile 将 整个 静态 资源 打包 ， 导 致 css/js AK 

4. 借鉴 了 PJAX 


A 


第 1 点 补充 : 


interface History { 

readonly attribute long length; 

readonly attribute any state; 

void go(optional long delta); 

void back(); 

void forward(); 

void pushState(any data, DOMString title, optional DOMString? 
url - null); 

void replaceState(any data, DOMString title, optional DOMStrin 
g? url - null); 


第 2 点 补充 : 


request -> 
response(title and body) «- 


request -» 
response(only body) «- 


AM AJAX 18 url BT > 


第 3 点 补充 : 


o 


有 人 说 Turblinks 就 是 为 了 解决 Assets Precompile 引起 的 问题 


第 4 点 补充 : 


$.pjax({ 
url: '/authors', 
container: 'Zmain' 


}) 


PJAX 是 指定 dom ° m Turblinks 是 整个 body. 


Turbolinks 3 
Ruby 层面 : 


Controller 

3 个 回调 方法 : 设置 X-XHR-Redirected-To* A4 GET 请 求 有 效 ， 某 种 情况 
的 跨 域 是 不 允许 的 

(用 到 了 X-XHR-Referer) 

重 写 referer 方法 (用 到 了 X-XHR-Referer ) 

更 改 redirect to 计算 规则 (用 到 了 X-XHR-Referer ) 

重 写 redirect to 方法 ， 某 种 情况 下 使 用 Turbolinks.visit 代替 

重 写 render 方法 ， 某 种 情况 下 使 用 Turbolinks.replace 代替 

render 和 redirect to 可 以 额外 处 理 参数 : turbolinks > keep » change 
' flush 

《各 个 参数 对 应 功能 可 以 查看 文档 ) 
Router 

加 上  turbolinks redirect to (用 到 了 HTTP X XHR REFERER ) 
View 

加 上 X-XHR-Referer 


共 引 入 标记 
cookies[:request method] 
request.headers['X-XHR-Referer'] 
request.headers["X-XHR-Referer"] 
session[: turbolinks redirect to] 
response.headers['X-XHR-Redirected-To'] 
env['HTTP X XHR REFERER'] 
env['rack.session'][: turbolinks redirect to] 
controller.request.headers["X-XHR-Referer"] 


JS Ed: 


定义 了 几 个 变量 

有 哪些 事件 ? 

fetch 是 如 何 实现 的 ? 

配置 要 不 要 缓存 

fetch 核心 部 分 之 ,.. (实际 上 是 XMLHttpRequest 对 象 ; 也 用 到 了 X-XHR-Refere 
r) 

fetchHistory 

cacheCurrentPage 

如 何 缓存 、 如 何 清 除 缓存 ? 

replace 

fetch, replace #82... (如何 才能 快速 且 有 效 的 替换 ?2 FetchReplacement ) 
window.history 记录 历史 链接 、 重 定向 链接 、 当 前 链接 和 状态 


clone 
各 种 乱七八糟 的 响应 格式 
过 期 
CSRFToken 
核心 之 .. .CreateDocument 
进度 条 
Sa 
进度 条 ABI 
其 它 : ua’ requestMethodIsSafe > browserSupportsTurbolinks > browsers 


upportsCustomEvents 
@Turbolinks 之 API 


文档 : 


10 个 事件 
整个 load 流程 
整个 replace 流程 
举例 说 明 可 以 如 何 使 用 这 些 事件 
ROBE 〈 介 绍 ， 如 何 工 作 ， 如 何 配置 ， 如 何 手动 调用 ) 
HRA (配置 要 不 要 用 即 可 ， 配 置 某 个 页 面 不 使 用 ) 
进度 条 (好 看 ， 并 且 浏览 器 自 带 的 进度 条 由 于 特性 没有 了 ) (配置 要 不 要 使 用 ， 配 置 样 
式 ， 手 动 调用 ) 
永久 保存 (配置 即 可 ) ， 例 如 全 局 的 侧 边 栏 ， 并 且 只 加 载 一 次 
配置 某 个 地 方 的 链接 不 使 用 turboolinks， 配 置 除 .html 外 其 它 后 组 的 链接 也 加 t 
urbolinks > 
配置 不 要 所 有 redirect to 都 使 用 turbolinks 特性 只 在 部 分 Controlle 
r 单独 引入 使 用 
允许 使 用 老 的 JS BK jquery.turbolinks (引入 即 可 ) 
配置 是 否 检测 JS 或 CSS 为 最 近 版 本 (假设 我 们 重新 部 署 ，md5 变 了 ， 有 时 候 tur 
bolinks 不 知道 ) 
配置 View 里 的 script 只 执行 一 次 ， 还 是 每 次 都 执行 
手动 调用 ， 明 确 的 指定 使 用 turbolinks 
局 部 替换 (也 可 以 配合 data-turbolinks-temporary 一 起 使 用 ) ... 
客户 端 : 要 手动 调用 方法 ; 服务 端 : 同样 的 ， 要 手动 调用 方法 
配置 (全 局 或 针对 某 个 请 求 ) ， 让 浏览 器 不 要 缓存 turbolinks 请 求 
客户 端 API (api 是 api， 事 件 是 事件 ， 不 要 搞 混 了 ) 
我 们 极度 依赖 pushState (在 这 里 ， 做 为 用 户 ， 我 们 就 不 要 考虑 了 吧 ~~) 


Turbolinks 补充 


简单 理解 概念 : 把 原来 所 有 GET 请 求 (包括 链接 、 重 定向 、 浏 览 器 的 后 退 ) 都 通过 
AJAX 来 实现 ， 并 且 Url 是 变化 的 。 


使 用 turblinks 的 话 ， 注 意 : 一 ， 尽 量 从 AJAX 的 角度 出 发 写 监 听 事 件 ; 二 ， 尽 量 使 
用 turblinks 提供 的 监听 事件 。 
Ruby 部 分 


重 写 了 ActionController::Base 里 的 redirect to 和 render 方法 


ActionController::Base.ancestors.select[|a| a.to s =~ /^Turbolin 
ks/} 
=> [Turbolinks::XHRHeaders, Turbolinks::Cookies, 
Turbolinks::XDomainBlocker, Turbolinks::Redirection] 


render 使 用 的 是 Turbolinks.replace 
redirect to 使 用 的 是 Turbolinks.visit 


处 理 :back 这 种 情况 ， 使 用 X-XHR-Referer 标识 
更 改 了 ur for 方法 (会 影响 到 link to 等 调用 到 它 的 方法 ) 


当 url for 使 用 到 :back 参数 时 有 用 ， 它 会 把 原来 header 里 的 HTTP_REFERER 
改 为 HTTP_X_XHR_REFERER 


原因 : Turbolinks 获取 内 容 的 时 候 使 用 XMLHttpRequest 发 起 请 求 (简称 XHR) 
带 来 的 问题 : XHR 请 求 的 HTTP X Referer 并 不 正确 


解决 办 法 : 添加 了 X-XHR-Referer 头 ， 后 端 程序 获取 Referer 的 时 候 ， 需 要 先 取 
X-XHR-Referer ° 


module XHRUrlFor 
def self.included(base) 
base.alias method chain :url for, :xhr referer 
end 


def url for with xhr referer(options = {}) 





options - (controller.request.headers["X-XHR-Referer"] || op 
tions) if options -- :back 
url for without xhr referer options 
end 
end 


# 辅助 方法 
def referer 
self.headers['X-XHR-Referer'] || super # super #2 self.header 
s['Referer'] 
end 
alias referrer referer 


Rá f Redirect 的 call 77% > 14 X redirect to 里 的 bug 


def call with turbolinks(env) 
status, headers, body - call without turbolinks(env) 


if env['rack.session'] && env['HTTP X XHR REFERER'] 
env['rack.session'][:. turbolinks redirect to] = headers['Loc 
ation'] 
end 


[status, headers, body] 
end 
alias method chain :call, :turbolinks 


注意 : 上 面 设 置 了 头 X-XHR-Redirected-To 
其 它 几 点 


一 ，3 MHF 


before action :set xhr redirected to, :set request method cookie 
after action :abort xdomain redirect 


1) AA trublinks 改变 了 原来 redirect to 的 行为 ， 带 来 了 新 的 问题 ， 然 后 它 又 提供 
了 解决 办 法 : 


def set xhr redirected to 
if session && session[: turbolinks redirect to] 


response.headers['X-XHR-Redirected-To'] = session.delete : 
.turbolinks redirect to 


end 
end 


对 应 redirect to :back 这 种 情况 ， 使 用 X-XHR-Referer 标识 ; 用 X-XHR- 
Redirected-To 记录 重 定向 的 目标 地 址 。 


2) 它 怎 么 记录 是 非 GET 请 求 的 呢 ? 用 cookies 记录 。 


def set request method cookie 
if request.get? 
cookies.delete(:request method) 
else 


cookies[:request method] = request.request method 
end 


end 


对 于 非 GET 74 > turblinks 是 不 起 作用 的 。 


3) 跨 域 重 定向 : 


def abort xdomain redirect 
to uri = response.headers['Location'] 
current = request.headers[ 'X-XHR-Referer' ] 
unless to uri.blank? || current.blank? || same origin?(curre 
nt, to_uri) 
self.status = 403 
end 
rescue URI::InvalidURIError 
end 


某 种 情况 下 ， 禁 止 访问 。 


JS 部 分 


所 有 对 外 API 


Public API 


Turbolinks 


Turbolinks. 
Turbolinks. 
Turbolinks. 
Turbolinks. 
Turbolinks. 
Turbolinks. 
Turbolinks. 
Turbolinks. 
Turbolinks. 
Turbolinks. 


.Visit(url) 


pagesCached( ) 
pagesCached(20) 


cacheCurrentPage() 


enableTransitionCache( ) 


disableRequestCaching() 


ProgressBar. 
ProgressBar. 
ProgressBar. 
ProgressBar. 
ProgressBar. 


enable() 
disable() 
start() 
advanceTo(80) 
done() 


Turbolinks.allowLinkExtensions( 'md') 
supported 


EVENTS 


Turbolinks. 
Turbolinks. 


visit, 

replace, 

pagesCached, 

cacheCurrentPage, 

enableTransitionCache, 

disableRequestCaching, 

ProgressBar: ProgressBarAPI (包括 : enable, disable, start, addv 
anceTo, done), 

allowLinkExtensions: Link.allowExtensions, 
supported: browserSupportsTurbolinks, 
EVENTS: clone(EVENTS) 


cacheSize 默认 缓存 10 个 页 面 
transitionCacheEnabled 事务 缓存 ? 默认 为 false 
requestCachingEnabled 请 求 缓存 ? 默认 为 true 


progressBar 进度 条 


currentState 当前 状态 
loadedAssets 加 载 资源 


referer 后 退 链接 


xhr 异步 请 求 


所 有 事件 : 
EVENTS = 

BEFORE CHANGE:  'page:before-change' 
FETCH: 'page:fetch' 
RECEIVE: 'page:receive' 

CHANGE : 'page:change' 
UPDATE: 'page:update' 

LOAD: 'page:load' 

RESTORE: 'page:restore' 
BEFORE UNLOAD:  'page:before-unload' 
EXPIRE: 'page:expire' 


具体 做 了 什么 事 ， 如 何 实现 ， 可 以 查看 对 应 源 代码 ， 在 此 不 做 讨论 。 


一 些 特性 
Transition Cache 


前 面 不 是 说 过 turblinks 默认 可 以 缓存 10 个 页 面 吗 ? 
现在 问题 来 了 3 如 果 我 要 访问 一 个 已 经 存在 缓存 里 的 页 面 9 它 是 "直接 从 缓存 里 
取 "， 还 是 " 改 为 了 AJAX 实现 重新 从 服务 端 取 " 呢 ? 


默认 还 是 从 " 改 为 了 AJAX 实现 重新 从 服务 端 取 "。 不 过 ， 你 可 以 通过 以 下 配置 ， 让 
它 "直接 从 缓存 里 取 " : 


Turbolinks.enableTransitionCache(); 


Partial replacements 


你 可 以 使 用 


Turbolinks.visit(path, options) 


A, 
Turbolinks.replace(html, options) 
实现 局 部 替换 HTML. 文档 内 容 。 


坑 及 策略 
事件 的 改变 


1) 点 击 链接 : 


page:before-change # 链接 刚刚 被 点 击 ，turblinks 刚 准 备 起 作用 的 状态 


page:fetch # 从 服务 端 获取 内 容 

page:receive # 已 经 收 到 服务 器 返回 内 容 ， 但 还 没 处 理 ( 去 掉 header 等 ) 
的 状态 

page:before-unload # 已 经 处 理 完成 ， 但 还 没 替 换 的 状态 

page:change 4 已 切换 到 新 页 面 的 状态 

page: load # 整个 点 击 彻底 的 完成 


2) 而 使 用 浏览 器 历史 返回 上 一 页 : 


page:before-unload # 页 面 已 经 从 缓存 里 取出 ， 准 备 切 换 


page:change # 已 切换 到 新 页 面 的 状态 
page:restore # 整个 回 退 彻底 的 完成 


Turbolinks 补充 


# 到 目前 为 止 ， 我 们 就 有 两 类 AJAX HRT ° 

# 一 是 turblink 转换 过 来 的 AJAX， 二 是 我 们 编写 的 、 丨 正 的 AJAX. 
# 使 用 下 面 这 个 状态 ， 可 以 同时 监听 上 述 两 种 AJAX 引起 的 页 面 变化 。 
page:update 


# 手动 缓存 当前 页 面 
Turbolinks.cacheCurrentPage(); 


# 页 面 缓存 数量 达到 上 限时 ， 触 发 它 
page:expire 


# 效果 和 fetch 一 样 ， 只 不 过 多 了 个 判断 。 
H 如 果 浏 览 器 支持 turblinks 那么 使 用 turblinks 的 fetch. 


# 如 果 浏 览 器 不 支持 turblinks 那么 使 用 普通 的 访问 
Turbolinks.visit 


# 局 部 替换 HTML 文档 内 容 


Turbolinks.replace 


JS 要 如 何 更 改 使 用 ? 


jquery.turbolinks 实践 ， 请 按照 AJAX 的 方式 写 JS 代码 。 


I Rz AST) 
$(function() ( 
Stdocument).on( click’, "button  ftunctron() { 2.2. }) 


3): 


JU mE UC AE 
S(document)-on( "click", 'button'- function() { ... }) 


和 


1012 


VI TRA 
$(document).on('ready', function () 1 77 ... *7 }); 


// 而 是 这 么 写 


$(document).ready(function () ( /* ... */ }); 
TorunetEon (Oo p 722.222 Sys 


怎样 防止 浏览 器 缓存 Turbolinks 请 求 : 


=] 


# 全 局 
Turbolinks.disableRequestCaching() 


# 每 个 请 求 
Turbolinks.visit url, cacheRequest: false 


像 jQuery.ajax(url, cache: false), 会 被 追加 " #{timestamp}" 到 GET 请 求 参数 里 。 
如 何 移 除 

# Gemfile 

ss a, ee IT: 

gem 'turbolinks' 

# app/assets/javascripts/application.js 


# 移 除 这 一 行 : 
//= require turbolinks 


4o RA js i£ 4448 T DOMContentLoaded 事件 ， 就 需要 为 Turbolinks 做 兼容 


BRAA LE GL» TUR ICT AERE : 


# Gemfile: 


gem 'jquery-turbolinks' 


4 Add it to 


//= 
//= 
//= 


JLA data-* 属性 


require 
require 
require 


. your 


require 


your JavaScript manifest file, in this order: 
jquery 

jquery.turbolinks 

jquery_ujs 


other scripts here ... 


turbolinks 


data-no-transition-cache 


data-turbolinks-permanent 


data-no-turbolink 


data-method, data-remote, or data-confirm 


data-turbolinks-track 


data-turbolinks-eval 


data-turbolinks-temporary 


原来 的 DOM 操作 怎么 办 ? FLEA 3ERR E 


DOM 操作 最 好 是 老 等 。 如 果 不 是 需 等 的 ， 你 可 以 使 用 使 用 page:load 而 不 是 
page:change 


// using jQuery for simplicity 


$(document).on("ready page:load", nonIdempotentFunction); 


其 它 类 和 对 象 


Click 管理 着 链接 和 点 击 事件 ， 触 发 时 会 进行 检查 。 如 果 符 合 trublinks 则 用 AJAX 
执行 请 求 ， 否 则 改 用 普通 的 请 求 。 


ProgressBar 进度 条 。 对 应 class name 为 turbolinks-progress-bar 


ProgressBarAPI 管理 进度 条 可 用 的 接口 。 有 : 


enable 
disable 


start 
done 


advanceTo 


CSRFToken 管理 csrf token， 提 供 接 口 : 


get 
update 


Link 对 于 已 经 存在 的 链接 ， 进 行 一 些 特殊 处 理 。 比如 ， 前 面 提 到 过 的 ， 有 的 链接 
不 能 使 用 turblinks 


各 种 浏览 器 不 同 引 起 的 问题 

如 何 替 换 链接 ? 

由 JS 实现 。 

wT Er KE A Referer ? 

压根 就 没有 丢失 ， 只 是 原来 的 不 能 用 ， 用 新 的 X-XHR-Referer 
参考 : 


Turbolinks 


jquery.turbolinks 
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rt Turbolinks 3 好 用 ， 代 码 事 整 洁 ， 文 档 也 更 友好 。 如 果 你 之 前 直接 关闭 了 
Turbolinks 的 话 ， 现 在 建议 你 尝试 一 下 。 


两 方面 : 一 、Ruby 层面 二 、JS 层面 


访问 方式 : GET 第 一 次 访问 页 面 GET 第 二 次 访问 页 面 刷新 页 面 重 定向 到 页 面 浏 
览 器 提供 的 "后退" 浏览 器 提供 的 “前 进 ” 


原理 : ajax Tid » KE url? 4$ head 部 分 、 直 接替 换 body 部 分 。 window 和 
document 保持 不 变 


底层 第 三 方 技术 : 重点 : HTML5 History API 

一 般 : Window.requestAnimationFrame XMLHttpRequest 

其 它 : MutationObserver Custom Elements 

工作 方式 : Turbolinks.xxx 直接 调用 data-turbolinks-xxx 间接 声明 


特殊 情况 ， 特 殊 处 理 : 一 般 都 是 通过 turbolinks-xxx data-turbolinks-xxx 等 方式 声 
明 当 时 是 特殊 情况 ， 要 求 特殊 处 理 。 


data-turbolinks data-turbolinks-action data-turbolinks-eval data-turbolinks-preview 
data-turbolinks-permanent data-turbolinks-track 


turbolinks-cache-control turbolinks-progress-bar turbolinks-root 


生命 周期 : turbolinks:click turbolinks:before-visit turbolinks:visit 
turbolinks:request-start turbolinks:request-end turbolinks:before-cache 
turbolinks:before-render turbolinks:render turbolinks:load 


内 部 实现 两 种 访问 方式 : 直接 从 缓存 里 拿 从 服务 器 响应 里 拿 
内 部 关键 术语 : Turbolinks-Location 
部 分 API : Turbolinks.visit Turbolinks.clearCache Turbolinks.supported 


问题 : 重复 执行 不 执行 首次 执行 ， 后 续 不 执行 document.read 等 老 的 写法 页 面 引 
入 Script 等 。 


EU! 先 看 官方 文档 (新 、 权 威 ) 再 看 源 代码 对 比 着 看 相关 参考 文章 
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Testing 


TODO 


Active Support 


包含 了 : Test Case ` Assertions ` Declarative ` Isolation ` Setup 和 Teardown 78 
X 3X ik ` Time Helpers ` Log Subscriber Test Helper 等 部 分 。 


Test Case 


assert nothing raised 


test/unit KR 
alias :assert raise :assert raises 
alias :assert not empty :refute empty 
alias :assert not equal :refute equal 
alias :assert not in delta :refute in delta 
alias :assert not in epsilon :refute in epsilon 
alias :assert not includes :refute includes 
alias :assert not instance of :refute instance of 
alias :assert not kind of :refute kind of 
alias :assert no match :refute match 
alias :assert not nil :refute nil 
alias :assert not operator :refute operator 
alias :assert not predicate :refute predicate 
alias :assert not respond to :refute respond to 
alias :assert not same :refute same 


test order 
test order- 


test order 支持 : 


ActiveSupport::TestCase.test order 


:random 
: parallel 
: sorted 
:alpha 


Assertions 


assert_difference 
assert_no_difference 


assert_not 


Declarative 


test 


Isolation 


类 方法 : 


forking env? 


实例 方法 : 


run 


Forking : 


run in isolation 


Subprocess : 


run in isolation 


Setup & Teardown 相关 类 方法 


setup 
teardown 


使 用 举例 : 


class ExampleTest < ActiveSupport 
setup do 


end 
teardown do 


end 
end 


文档 没 写 ， 但 还 有 : 


before setup 
after teardown 


Time Helpers 


travel 
travel back 
travel to 


Log Subscriber - Test Helper 


::TestCase 


set. 


logger 


setup 
teardown 


wait 


使 用 举例 : 


class SyncLogSubscriberTest < ActiveSupport::TestCase 


include ActiveSupport::LogSubscriber::TestHelper 


det setup 
ActiveRecord::LogSubscriber.attach to(:active record) 

end 

def test basic query logging 


Developer.all.to a 

wait 4 «-- 这 个 

assert equal 1, Qlogger.logged(:debug).size 

assert match(/Developer Load/, Qlogger.logged(:debug).last) 
assert match(/SELECT N* FROM "developers"/, Qlogger.logged(: 


debug).last) 
end 


end 


File Fixtures 


file fixture 


Constant Lookup 


determine constant from test name 





Deprecation 


assert deprecated 
assert not deprecated 


Active Job 
Test Helper 
实例 方法 : 


assert_enqueued with 
assert performed with 


assert enqueued jobs 
assert performed jobs 


assert no enqueued jobs 
assert no performed jobs 


perform enqueued jobs 


VAR: 


delegate :enqueued_jobs, :enqueued_jobs=, :performed_jobs, 


ormed_jobs=, 
to: :queue_adapter 


和 其 它 测试 一 样 ， 你 也 可 以 自己 编写 前 后 过 滤器 : 
before_setup 


after teardown 


默认 测试 环境 下 使 用 queue adapter Æ test ^ Ki: 


Rails.application.config.active_job.queue_adapter 


= :test 


perf 


Active Job 
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Action Mailer 


Test Helper 


默认 Rails 提供 两 个 helper 方法 用 于 测试 : 


方法 解释 
assert emails 断言 已 经 发 送 的 邮件 数 
ae 言 没 有 邮件 发 送出 去 (可 用 assert emails 0 
ES uH 
assert enqueued emails 断言 邮件 已 进 队 列 


assert no enqueued emails 断言 邮件 不 在 队列 里 
assert emails 和 assert no emails 两 者 本 质 都 是 封装 assert equal. 
Behavior 
类 方法 : 

determine default mailer 

mailer class 


tests 


initialize test deliveries 


restore delivery method 
restore test deliveries 


set delivery method 
set expected mail 


除 通常 的 测试 方法 外 ， 还 有 deliveries 方法 获取 已 经 发 送 的 邮件 实例 。 


使 用 举例 : 


last email = ActionMailer::Base.deliveries.last 


expect(last email.to).to eq ['test@example.com' ] 
expect(last email.subject).to have content 'Welcome' 


email - UserMailer.confirmation(user.id).deliver now 


assert ActionMailer::Base.deliveries.any? 
assert equal [user.email], email.to 


Action Controller 


Test Case Behavior 


实例 方法 : 


get 
post 
patch 
put 
delete 
head 


xhr & xml http request 


process 
Rails 5 新 增 xhr 虽然 是 语法 糖 ， 但 用 起 来 很 舒心 ， 不 是 吗 ? 
Live Test Response 


Success? & successful? 
missing? & not found? 
error? & server error? 


Action Dispatch 
Assertions 
实例 方法 : 


html document 


Response Assertions : 


assert redirected to 
assert response 


Routing Assertions : 


assert generates 
assert recognizes 
assert routing 


with routing 


Test Process 


assigns 
cookies 
flash 


session 


fixture file upload 
redirect to url 


Test Request 


accept- 
action- 


cookies & rack cookies 
host- 


if modified since- 
if none match- 


path= 
port= 


remote_addr= 
request_method= 


request_uri= 


user_agent= 


Test Response 


from_response 


response successful? 


success? & successful? 
IRL not found? 

missing? & not_found? 

redirect? & redirection? 


Servers Ser eg noise 


error? & server_error? 


Integration Test 


类 方法 : 


app 
app- 


实例 方法 : 


app 
document root element 


url options 


Request Helpers : 


delete 


delete via redirect 


follow redirect! 


get 


get via redirect 


head 


patch 


patch via redirect 


post 


post via redirect 


put 


put via redirect 


request via redirect 


xhr & xml http request 


Session : 


cookies 


host 


https? 
https! 


reset! 


url_options 


Runner : 


app 


default_url_options 
default_url_options= 


open_session 


reset! 


Action View 
Behavior 
实例 方法 : 

config 


render 
rendered views 


setup with controller 
类 方法 : 


determine default helper class 


helper class 
helper method 


tests 


Rendered Views Collection : 


add 
locals for 


rendered views 


view rendered? 


Test Controller 


controller path- 
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Generators 
Assertions 


assert class method 
assert instance method & assert method 


assert file & assert directory 
assert no file & assert no directory 


assert migration 
assert no migration 


assert field type 
assert field default value 


Behaviour 

RAK: 
arguments 
destination 


tests 


实例 方法 : 
create generated attribute 
generator 


run generator 


其 它 实例 方法 : 


capture 


Setup-And-Teardown 


setup 
teardown 


Note: 上 述 模块 们 于 generators/testing/ 目录 下 。 


rails-dom-testing 


rails-dom-testing 
从 ActionView 分 离 出 来 的 gem， 主 要 由 以 下 两 部 分 构成 : 


Dom Assertions 


assert dom equal '<hi>Lingua Franga</hi>', '<hi>Lingua Franga</h 
do 


assert dom not equal '<h1>Portuguese</h1>', '<h1>Danish</h1>' 


Selector Assertions 


# implicitly selects from the document root element 
css select '.hello' # => Nokogiri::XML::NodeSet of elements with 
hello class 


4 select from a supplied node. assert select asserts elements ex 
ist. 
assert_select document_root_element.at('.hello'), '.goodbye' 


# elements in CDATA encoded sections can also be selected 
assert_select_encoded '#out-of-your-element' 


# assert elements within an html email exists 
assert_select_email '#you-got-mail' 


MiniTest 


链接 minitest 


Spec DSL 
实例 方法 : 
it 


let 
subject 


before 
after 


it 和 deftest x 类 似 。 一 般 的 ， 每 一 个 测试 案例 对 应 着 一 个 测试 方法 。 可 用 让 定 
义 它们 。 


let 和 def 定义 方法 类 似 ， 只 不 过 这 里 方法 内 容 始终 是 block. 有 延迟 加 载 的 作 
用 。 


subject Fr let 类似 ， 但 它 没有 名 字 。( 其 实 它 是 有 名 字 的 ， 始 终 是 subject) 

before 前 置 过 滤器 ， 在 每 一 个 让 之 前 执行 。( 名 字 无 所 谓 ， 只 是 起 标识 作用 而 矣 ) 

after 后 置 过 滤器 ， 在 每 一 个 it 之 后 执行 。( 名 字 无 所 谓 ， 只 是 起 标识 作用 而 锋 ) 
before ` after 方法 和 RSpec 里 的 setup ` teardown 方法 有 对 应 关系 。 

除 上 述 方法 外 ， 还 有 : 


Spec_type 
register spec type 


children 


链接 MiniTest::Spec::DSL 


Assertions 


实例 方法 : 


assert 

assert empty 
assert equal 
assert in delta 
assert in epsilon 
assert includes 
assert instance of 
assert kind of 
assert match 
assert nil 

assert operator 
assert output 
assert predicate 
assert raises 
assert respond to 
assert same 
assert send 
assert silent 
assert throws 


refute 

refute empty 
refute equal 
refute in delta 
refute in epsilon 
refute includes 
refute instance of 
refute kind of 
refute match 
refute nil 

refute operator 
refute predicate 
refute respond to 
refute same 


pass 
skip 


flunk 


除 上 述 方法 外 ， 还 有 : 


capture io 
capture subprocess io 


diff 

exception details 

message 

mu pp 4 表示 human-readable pretty print 
mu pp for diff 

skipped? 


synchronize 


类 方法 : 


diff 
diff- 


链接 MiniTest::Assertions 


Mock 
类 方法 : 


expect 
verify 


IT 


expect 第 一 个 参数 为 方法 名 ， 第 二 个 参数 为 执行 此 方法 后 返回 的 结果 ， 第 
参数 表示 传递 给 此 方法 的 参数 ， 也 可 以 传递 一 个 block. 


使 用 举例 : 


4 Expect that method name is called, optionally with args or a b 
lk, and returns retval. 
m = Minitest::Mock.new 
m.expect(:raiser, nil) do |args| 
raise RuntimeError, "this code path triggers an exception" 
end 


我 们 可 以 使 用 Minitest::Mock.new 模拟 一 些 不 能 (或 不 希望 ) 直 接 调用 的 对 象 。 


user = Minitest::Mock.new 
user.expect(:delete, true) # returns true, expects no args 


UserDestoyer.new.delete user(user) 


assert user.verify 


verify mock 出 来 的 对 象 有 时 候 并 不 是 我 们 想 要 的 (计算 机 不 够 聪明 )，verify 验 
证 是 否 真 的 执行 了 上 述 方法 。RSpec 在 这 点 上 使 用 起 来 更 简洁 ， 但 也 相差 不 大 。 


链接 MiniTest::Mock 


包含 TestCase ` Lifecycle Hooks 和 Guard 三 部 分 。 


TestCase 
实例 方法 : 


Setup 
teardown 


kik FIR > A: 


io 
io? 


run 


passed? 


类 方法 : 





i suck and my tests are order dependent! # 让 测试 按照 顺序 执行 | 
make my diffs pretty! # 错误 日 志 格 式 化 ， 更 漂亮 ， 但 会 降 慢 速度 
parallelize me! # 并 行 执 行 测试 

benchmark suites 

bench exp 


bench linear 
bench range 


链接 MiniTest::Unit::TestCase 


Lifecycle Hooks 
实例 方法 : 


after setup 
after teardown 


before setup 
before teardown 


链接 MiniTest::Unit::LifecycleHooks 


Guard 
类 方法 : 


maglev? 


实例 方法 : 


jruby? 
mri? 
rubinius? 
windows? 


TestCase VA mixed 的 方式 引入 此 模块 ， 所 以 可 以 以 类 方法 的 形式 调用 这 里 的 实例 
方法 。 


链接 MiniTest::Unit::Guard 


可 以 用 assert x fe refute x KARHI 83 AK > SUM fe LK Map AE o 


实例 方法 : 


4 以 下 方法 和 RSpec 对 应 ， 可 以 使 用 assert x KH 

must_be 

must be close to 

must be empty 

must be instance of # 范围 比 kind of 小 ， 子 类 的 实例 不 行 
must be kind of 4 范围 比 instance of 大 ， 子 类 的 实例 也 行 
must be nil 

must be same as 

must be silent 

must be within delta 

must be within epsilon 

must equal 

must include 

must match 

must output 

must raise 

must respond to 

must send 

must throw 


# must x 和 wont x 意思 正好 反 着 来 


# 以 下 方法 和 RSpec 对 应 ， 可 以 使 用 refute x 代替 
wont be 

wont be close to 
wont be empty 

wont be instance of 
wont be kind of 
wont be nil 
wont be same as 

wont be within delta 
wont be within epsilon 
wont equal 

wont include 

wont match 

wont respond to 


链接 MiniTest::Expectations 
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rd 


它 

其 它 多 个 类 或 模块 ， 统 一 在 此 列举 。 
Kernel 

很 常用 的 方法 : 


describe 


Object 


常用 的 方法 : 

stub 
保存 调用 此 方法 的 值 ， 下 次 再 调用 此 方法 ， 直 接 使 用 该 值 ， 不 用 重新 计算 生成 。 
举例 : 


DateTime.now 


^ 


+ => 2014-11-17T22:16:15+08:00 


DateTime.stub :now, (Date.today.to_date - 14) do 
puts DateTime.now 


puts DateTime.now 


end 
=> 2014-11-03 
= 2014-11-03 
Benchmark 


已 经 mixed 3* TestCase. 


类 方法 : 


bench_exp 
bench linear 
bench range 


实例 方法 : 


assert performance 

assert performance constant 
assert performance exponential 
assert performance linear 
assert performance logarithmic 
assert performance power 


fit error 

fit exponential 
fit linear 

fit logarithmic 
fit power 


sigma 


validation for fit 


Bench Spec 

类 方法 : 
bench 
bench performance constant 
bench performance exponential 


bench performance linear 
bench range 


Abstract Reporter 


实例 方法 : 


passed? 


record 
report 


start 


Assertion 


实例 方法 : 


location 


Factory Girl 
可 用 于 构建 record 对 象 的 方法 
构建 单个 对 象 : 

build 

create 


attributes for 
build stubbed 


使 用 举例 : 
build(:completed order) 
create(:post) do |post| 
create(:comment, post: post) 
end 


attributes for(:post, title: "I love Ruby!") 


build stubbed(:user, :admin, :male, name: "John Doe") 


构建 多 个 对 象 : 


build list 
create list 
attributes for list 
build stubbed list 


使 用 举例 : 


build list(:completed order, 2) 
create list(:completed order, 2) 


attributes for list(:post, 4, title: 


build stubbed list(:user, 15, :admin, 


链接 FactoryGirl Syntax Methods 


Getting Started 
Linting Factories 


类 方法 : 


lint 


Defining factories 
类 方法 : 
define 
实例 方法 : 
factory 
(定义 factory.) 
Lazy Attributes 


定义 属性 时 ， 大 括号 (p 的 使 用 。 


Aliases 


:male, 


name: 


"I love Ruby!") 


"John Doe") 


调用 factory 时 ， 可 选 参数 :aliases 的 使 用 (给 factory 起 外 号 )。 


Dependent Attributes 


{} 大 括号 里 面 求 值 (拼接 字符 串 )。 


Transient Attributes 


transient 


(在 定义 factory 的 代码 内 同时 定义 方法 ， 之 后 使 用 到 ) 


Associations 


association 


以 及 它 的 可 选 参数 :factory 和 :strategy 
(关联 对 象 的 factory.) 

Inheritance 

KEA factory 方法 。 

或 factory 的 可 选 参数 :parent 

(继承 已 有 的 factory.) 


Sequences 


sequence 


generate 


( 按 顺 序 生成 factory 的 属性 内 容 ) 

Traits 

定义 :用 trait 进行 定义 。 

调用 : factory 的 可 选 参 数 straits 或 直接 调用 。 
(避免 重复 代码 ) 


Callbacks 


默认 已 经 有 : 
after(:build) 
before(:create) 


after(:create) 
after(:stub) 


(创建 factory 时 的 回调 ) 
自 定义 : 
callback 
Modifying factories 
类 方法 : 
modify 
(更 改 已 有 factory. 场景 : 在 rails c 里 检验 ) 
Building or Creating Multiple Records 


build list 
create list 


build pair 
create pair 


(批量 创建 factory 对 象 ) 
Custom Construction 
initialize with 


attributes 


需要 自 定 义 相关 类 及 方法 。 
(Model 里 使 用 了 initialize 并 设置 了 实例 变量 ) 
Custom Strategies 


类 方法 : 
register strategy 
需要 自 定 义 相关 类 及 方法 。 


( 自 定 义 factory 对 象 的 生成 规则 ) 


Custom Callbacks 

callback 
4% "Custom Strategies" 会 自动 添加 上 述 默认 的 Callbacks. 
Custom Methods to Persist Objects 


to_create 


skip create 


(重新 定义 并 调用 "保存 方法 " ; 915€ factory 对 象 的 时 候 跳 过 "保存 ") 
重新 加 载 factory 


类 方法 : 


find definitions 


链接 Getting Started 


an 
< 
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一 些 建议 : 


看 新 代码 。Rails 版 本 更 新 太 快 ， 无 论 是 新 手 还 是 老手 ， 都 建议 从 新 的 开始 学 

习 。 不 看 新 代码 ， 之 前 在 旧版 本 里 遇 到 的 问题 或 解决 方案 ， 或 许 新 版 本 已 经 有 
了 更 好 的 解决 方案 ， 并 且 还 新 增 了 一 些 新 特性 可 以 使 用 。 

各 个 release note 一 定 要 认真 看 ! 你 不 需要 知道 整个 改进 过 程 ， 但 是 要 大 致 了 
fi o 

不 用 想 着 什么 都 学 会 了 ， 才 动手 。 几 乎 不 可 能 (也 没 必要 ) 全 部 知识 都 能 学 会 ， 

并 且 知 识 从 实践 中 来 ， 只 有 动手 做 过 才能 掌握 、 熟 练 。 

知识 点 尽量 全 面 。 有 时 候 我 们 重复 轮 予 ， 既 花 时 间 又 不 够 理想 ， 却 不 知 有 些 方 
ik Rails 已 经 内 置 ， 直 接 用 即 可 。 

不 用 完全 迷信 ' 和 更 优雅 '。 框 架 ， 顾 名 思 义 ， 提 供 了 方便 也 会 有 限制 。 当 实际 需求 
需要 的 时 候 ， 没 必要 什么 事 都 往 框 架 提 供 的 内 置 方法 去 套 。 应 该 优先 考虑 完成 
任务 ， 及 后 续 阅 读 、 维 护 。 


尽量 简洁 。 

REJEA ` iE g k AHA É o 

帮助 人 理解 Rails 5 整体 架构 ， 做 他 们 阅读 源 代 码 的 带路 人 。 

对 API 的 补充 。 

理解 Rails 的 优雅 之 处 。 (有 些 东 西 ， 我 们 自己 也 可 以 做 ， 但 Rails 提供 了 ， 而 
且 更 优雅 ; 我 们 需要 理解 它 ， 然 后 使 用 它 ) 

使 用 和 原理 相 结合 。 尽 量 两 者 兼顾 ， 把 握 好 度 。 

重要 的 是 解决 问题 的 能 力 ， 而 非 专家 。 

没有 最 好 的 解决 方案 。 

当 你 不 确定 时 ， 不 妨 多 敲 几 行 代 码 ， 以 防 万 一 。 


目标 读者 : 普通 Rails Web 开发 者 。 


